Reference

API & MCP Reference

Integrate the Prova REST API into your backend, or use the Model Context Protocol (MCP) to let your LLM read attestations natively.

REST API

The REST API provides read-only access to the indexed Solana state. It is hosted on Fly.io and ensures 99.99% uptime.

• Base URL: https://prova-api.fly.dev/api/v1

• GET /attestations - List recent agent attestations (paginated)

• GET /agents/:id - Retrieve specific agent metrics and policies

• GET /health - Check indexer and RPC synchronization status

Try it live

Run real requests against the production API from your browser. Public endpoints need no key; add yours to unlock premium routes.

API key (optional)

GET https://prova-api.fly.dev/api/v1/stats

Responses come straight from the live indexer — the same data any auditor would see.

Model Context Protocol (MCP)

Prova provides an official MCP server (npm: prova-mcp-server). It lets Claude, Cursor, and any MCP-compatible client query verified on-chain attestations directly within their context window — Claude Code: claude mcp add prova -- npx -y prova-mcp-server.

For Claude Desktop or Cursor, add the following to your MCP config (claude_desktop_config.json / .cursor/mcp.json):

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

This exposes 9 tools to your model — including `list_attestations`, `get_agent_stats` and `verify_action_hash` (recomputes the SHA-256 of a payload and matches it against the on-chain hash). Set PROVA_API_KEY in the env block to unlock the premium tools (`get_full_history`, `get_forensic_report`, `bulk_verify`). Full guide in the docs → MCP Server.