MCP Discovery

Discover available tools on a registered MCP server.

POST /runtime/mcp/discover runs policy evaluation, then calls tools/list on the registered MCP server. Results are filtered by the agent's allowed_tools allowlist if configured.

bash

curl -X POST https://app.korclaw.com/api/v1/runtime/mcp/discover \
  -H "Authorization: Bearer kc_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "analytics",
    "input": {
      "action": "discover_tools",
      "agent": "research-agent",
      "environment": "production"
    }
  }'

Response

{
  "data": {
    "allowed": true,
    "result": "allowed",
    "server": "analytics",
    "tools": [
      {
        "name": "search_documents",
        "description": "Search indexed documents",
        "inputSchema": { "type": "object", "properties": { "query": { "type": "string" } } }
      }
    ]
  }
}

Request bodies must not include transport_url, url, upstream, or endpoint fields. Only registered server slugs or IDs are accepted.