MCP Server

The official Prova MCP server (`prova-mcp-server`) connects Claude, Cursor, and any Model Context Protocol client to the attestation layer. Your assistant can ask "what did agent X do on Tuesday?" and get verifiable on-chain answers — no explorer tab needed.

What it is

A read-only MCP server over stdio. It queries the public Prova REST API (the indexed projection of the on-chain program) and verifies hashes locally. It never holds keys, never signs, never moves funds. Node.js 18+ is the only requirement — npx handles the rest.

Setup

Claude Code

claude mcp add prova -- npx -y prova-mcp-server

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "prova": {
      "command": "npx",
      "args": ["-y", "prova-mcp-server"]
    }
  }
}

Cursor

Add the same block to .cursor/mcp.json (per project) or ~/.cursor/mcp.json (global). Any other MCP-compatible client works identically — the server speaks standard MCP over stdio.

Tools

Tool	What it answers
`get_stats`	"How many agents and attestations does the network have?"
`list_attestations`	"What did agent X do this week?" — filters by agent, action type, date range.
`get_attestation`	"Show me receipt Y" — hash, type, signature, timestamp.
`get_agent`	"Who operates agent X? Is it revoked?"
`get_agent_stats`	"What does this agent do most — swaps or tool calls?"
`verify_action_hash`	"Does this payload match the on-chain receipt?" — recomputes SHA-256 locally and compares.
`get_full_history`	Premium: complete history, up to 1000 receipts.
`get_forensic_report`	Premium: structured report for audits/compliance.
`bulk_verify`	Premium: verify up to 1000 receipt PDAs at once.

Configuration

Env variable	Default	Purpose
`PROVA_API_URL`	`https://prova-api.fly.dev`	Prova REST API base URL.
`PROVA_API_KEY`	—	Optional `prova_…` key. Unlocks the three premium tools. Generate at `theprova.xyz/app/api-keys`.

With premium key

{
  "mcpServers": {
    "prova": {
      "command": "npx",
      "args": ["-y", "prova-mcp-server"],
      "env": {
        "PROVA_API_KEY": "prova_...",
        "PROVA_API_URL": "https://prova-api.fly.dev"
      }
    }
  }
}

Without a key, the six public tools work fully. The premium tools respond with a clear setup instruction instead of failing silently.

Why this matters

LLMs answering questions about agent behavior usually rely on the operator's logs — exactly the thing Prova distrusts by design. With MCP, the model reads the cryptographic record: every answer can cite an on-chain transaction anyone can check.