io.github.The-Pixel-Boys/shield-kya MCP Server

Name: io.github.The-Pixel-Boys/shield-kya MCP Server
Author: io.github.The-Pixel-Boys

io.github.The-Pixel-Boys/shield-kya

Repository Registry

What is the io.github.The-Pixel-Boys/shield-kya MCP server?

KYA MCP gate: evaluate, ingest, request approval. Sole PEP is Shield.

How to install io.github.The-Pixel-Boys/shield-kya

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

KYA_BASE_URL
required
Control plane origin (e.g. http://127.0.0.1:8090 or hosted URL)
KYA_API_KEY
required
secret
API key for the control plane (required when auth is on)
KYA_HOST
Dual-plane host tag: ide (authoring) or runtime (production)
KYA_AGENT_ID
Registered agent principal id

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shield-kya": {
      "command": "npx",
      "args": [
        "-y",
        "@shield-agent/kya",
        "serve-mcp",
        "--stdio"
      ],
      "env": {
        "KYA_BASE_URL": "<YOUR_KYA_BASE_URL>",
        "KYA_API_KEY": "<YOUR_KYA_API_KEY>",
        "KYA_HOST": "<YOUR_KYA_HOST>",
        "KYA_AGENT_ID": "<YOUR_KYA_AGENT_ID>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "shield-kya": {
      "command": "npx",
      "args": [
        "-y",
        "@shield-agent/kya",
        "serve-mcp",
        "--stdio"
      ],
      "env": {
        "KYA_BASE_URL": "<YOUR_KYA_BASE_URL>",
        "KYA_API_KEY": "<YOUR_KYA_API_KEY>",
        "KYA_HOST": "<YOUR_KYA_HOST>",
        "KYA_AGENT_ID": "<YOUR_KYA_AGENT_ID>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shield-kya": {
      "command": "npx",
      "args": [
        "-y",
        "@shield-agent/kya",
        "serve-mcp",
        "--stdio"
      ],
      "env": {
        "KYA_BASE_URL": "<YOUR_KYA_BASE_URL>",
        "KYA_API_KEY": "<YOUR_KYA_API_KEY>",
        "KYA_HOST": "<YOUR_KYA_HOST>",
        "KYA_AGENT_ID": "<YOUR_KYA_AGENT_ID>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "shield-kya": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shield-agent/kya",
        "serve-mcp",
        "--stdio"
      ],
      "env": {
        "KYA_BASE_URL": "<YOUR_KYA_BASE_URL>",
        "KYA_API_KEY": "<YOUR_KYA_API_KEY>",
        "KYA_HOST": "<YOUR_KYA_HOST>",
        "KYA_AGENT_ID": "<YOUR_KYA_AGENT_ID>"
      }
    }
  }
}

Claude Code

claude mcp add shield-kya --env KYA_BASE_URL=<YOUR_KYA_BASE_URL> --env KYA_API_KEY=<YOUR_KYA_API_KEY> --env KYA_HOST=<YOUR_KYA_HOST> --env KYA_AGENT_ID=<YOUR_KYA_AGENT_ID> -- npx -y @shield-agent/kya serve-mcp --stdio