Surfaces

MCP server

Give an AI agent a deterministic verify tool.

The Calma MCP server exposes verification as a tool for AI agents (Claude, and any MCP client) — AI proposes a number, determinism disposes. It is transport-only: every tool shells out to the CLI and returns the engine's verdict verbatim, never computing a verdict itself.

pip install "calma[mcp]"
export CALMA_API_KEY=calma_sk_...
python -m calma_mcp        # stdio

Client config

Add to your MCP client (e.g. Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "calma": {
      "command": "python",
      "args": ["-m", "calma_mcp"],
      "env": {
        "CALMA_API_KEY": "calma_sk_...",
        "CALMA_API_URL": "https://calma-engine.fly.dev"
      }
    }
  }
}

Tools

Tool	What it does
`calma_verify`	Re-run a repo and return a per-claim verdict (`repo`, `deep`, `entry`)
`calma_scans`	List your recent scans and their verdict counts

The agent gets a verdict it cannot fake — the result is always the engine's deterministic recompute, never the agent's own claim.