Shield Agent AI
Integrations

Medusa of hosts, not an island

Each coding host is a tentacle. Shipped recipes below. New hosts land via public PR — then they show here and on the homepage strip.

npm i -g @shield-agent/kya@latest && kya start

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

Claude Code / Desktop

Project .mcp.json or Desktop settings from claude/claude_desktop_config.example.json.

"shield-kya": {
  "command": "kya",
  "args": ["serve-mcp", "--stdio"],
  "env": { "KYA_HOST": "ide", "KYA_OFFLINE": "1" }
}

Cursor

.cursor/mcp.json plus .cursor-plugin/plugin.json in the package.

Codex CLI / IDE

Copy openai/codex.config.example.toml into ~/.codex/config.toml. Hosted: url = "https://shield-agent.com/mcp" with Bearer env.

Gemini CLI

Merge gemini/settings.example.json (stdio) or gemini/settings.hosted.example.json into ~/.gemini/settings.json.

Grok / custom MCP

Hosted connector: https://shield-agent.com/mcp (see grok/README.md). Grok rejects localhost — use hosted or a tunnel for local demos.

OpenCode · coming soon

Want it first? Ship a recipe via the contribute path below.

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