kya start writes .mcp.json, mcp.json, and .cursor/mcp.json, then opens the live receipt.

One command - kya connect

The CLI writes the host config itself. It merges, never clobbers, and --project scopes the wiring to one repo where the host supports it.

Cursor (IDE + Agent CLI)

kya connect cursor → ~/.cursor/mcp.json. One config covers the IDE and the Agent CLI. Full recipe (verify step, uninstall, troubleshooting).

OpenCode

kya connect opencode → ~/.config/opencode/opencode.json. Local MCP entry under the mcp key; project scope supported. Full recipe (verify step, uninstall, troubleshooting).

Qwen Code

kya connect qwen → ~/.qwen/settings.json. Stdio or hosted variant; never enable both. Full recipe (verify step, uninstall, troubleshooting).

Kimi Code CLI

kya connect kimi → ~/.kimi-code/mcp.json. Standard mcpServers entry. Full recipe (verify step, uninstall, troubleshooting).

Kiro CLI

kya connect kiro → ~/.kiro/settings/mcp.json. Standard mcpServers entry; project scope supported. Full recipe (verify step, uninstall, troubleshooting).

Kilo Code CLI

kya connect kilo → ~/.config/kilo/kilo.json. Same local-server shape as OpenCode. Full recipe (verify step, uninstall, troubleshooting).

MastraCode

kya connect mastracode → ~/.mastracode/mcp.json. Standard mcpServers entry. Full recipe (verify step, uninstall, troubleshooting).

Amp

kya connect amp → ~/.config/amp/settings.json. Amp prefixes its root key: amp.mcpServers, not mcpServers. Full recipe (verify step, uninstall, troubleshooting).

GitHub Copilot CLI

kya connect copilot → ~/.copilot/mcp-config.json. Global config only - no project scope. Full recipe (verify step, uninstall, troubleshooting).

Config recipe

Copy a shipped example into the host config. The path or schema is known, but not safe to write programmatically (TOML conventions, IDE globalStorage, hosted-only UIs).

Claude Code / Desktop / claude.ai

.mcp.json or Desktop settings. kya start wires .mcp.json; Desktop and claude.ai use shipped examples. Full recipe (example file, verify step, troubleshooting).

Codex (OpenAI)

~/.codex/config.toml. TOML config with its own conventions - merge the example by hand. Full recipe (example file, verify step, troubleshooting).

Gemini CLI

~/.gemini/settings.json. Merge the stdio or hosted example; keep trust:false. Full recipe (example file, verify step, troubleshooting).

Grok

https://shield-agent.com/mcp. Hosted-only: grok.com rejects localhost. Never tunnel the OSS server. Full recipe (example file, verify step, troubleshooting).

Cline (VS Code)

VS Code globalStorage. Config lives in VS Code globalStorage - merge by hand. Weakest MCP coverage of the MCP hosts. Full recipe (example file, verify step, troubleshooting).

Droid (Factory)

~/.factory/mcp.json. Prefer droid mcp add; on-disk schema is unverified. Full recipe (example file, verify step, troubleshooting).

Any CLI - kya wrap

These hosts have no documented MCP support. kya wrap --offline evaluates the invocation before it runs and records the verdict on the trail. Coverage is the wrapped command only - the agent's own tool calls inside a session are not gated.

Pi

No documented MCP support. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

OMP

Local model-runner CLI, no MCP. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

Devin CLI

Cloud dev agent. Wrap gates the launch command, not actions inside its environment. Full recipe (wrap command, trail check, what is not covered).

Hermes Agent

No documented MCP support. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

Qoder CLI

No documented MCP support. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

Maki

No documented MCP support. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

Muse

No documented MCP support. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

Antigravity CLI

No documented MCP support. kya wrap gates the invocation only. Full recipe (wrap command, trail check, what is not covered).

Contribute a host recipe

1. Fork shield-kya.
2. Add a config example under a host folder (stdio and/or hosted HTTP).
3. Document env vars, restart steps, and one smoke wrap.
4. Open a PR with the host-recipe template. Merged recipes appear here.

Guide: docs/host-recipe.md · raw MCP descriptor: /connectors/mcp.json