MCP

MCP is a translator. It does not recompute the schedule. It forwards to the existing REST catalog.

Transports

• Stdio: python -m app.mcp_stdio. For a local process. Set BSI_BASE_URL and BSI_API_KEY.
• Streamable HTTP: POST https://api.bellatorsi.com/mcp. One JSON-RPC message per request. The response is JSON. GET and DELETE return 405.

Auth on HTTP is x-api-key or Authorization: Bearer.

Default tools

Tool	Path
health_score	POST /api/v1/health/score
health_logic_audit	POST /api/v1/health/logic-audit
analysis_validate	POST /api/v1/analysis/validate

GET /mcp/tools lists the full catalog. The default agent attach exposes the three above. Simulation tools are not listed.

Keys

• Playground mint issues a demo key. It includes forensics.
• Agent mint POST /api/v1/keys/ephemeral/generate/agent issues a free key. Health and analysis only.
• A paid key is a normal account key. Put it in BSI_API_KEY. No separate agent product.

Forensics on a free key returns TIER_REQUIRED and a signup URL.

Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "health_score",
    "arguments": {
      "tasks": [
        { "id": "T1", "duration_days": 1, "predecessors": [] }
      ]
    }
  }
}

The result content[0].text is the REST response. isError is false on a completed check, including a failing score.