Shield Agent AI
Connectors

Add Shield as an MCP server

Paste this into the host. Same tools as /connectors/mcp.json.

MCP snippet

Any MCP host. host=ide while authoring, host=runtime in production.

{
  "mcpServers": {
    "shield-kya": {
      "command": "npx",
      "args": ["-y", "@shield-agent/kya", "serve-mcp", "--stdio"],
      "env": {
        "KYA_BASE_URL": "https://shield-agent.com",
        "KYA_API_KEY": "${KYA_API_KEY}",
        "KYA_HOST": "ide"
      }
    }
  }
}

Offline demo (no plane): npx @shield-agent/kya@latest eval-tool --offline --tool-id org.sample.never.event --irreversible

Tools

ToolDoes
kya.policy_evaluateALLOW, DENY, or REQUIRE_APPROVE
kya.session_ingestObserve a session (raise-only)
kya.request_approvalOpen a human request. Does not run the side effect.

HTTP

  • POST /api/v1/kya/policy/evaluate
  • POST /api/v1/kya/sessions/ingest
  • POST /api/v1/kya/approvals
  • Descriptor: /connectors/mcp.json

Hosted key: Sign in then Install agents. Offline npx walkthrough: /install#npx.