Ask the ledger from your AI

Connect it in one step

The endpoint speaks the Model Context Protocol over Streamable HTTP. It needs no authentication and keeps no session: every request is answered on its own.

https://agenticfinancegraph.com/mcp

claude mcp add --transport http afg https://agenticfinancegraph.com/mcp

{
  "mcpServers": {
    "afg": {
      "url": "https://agenticfinancegraph.com/mcp"
    }
  }
}

{
  "servers": {
    "afg": {
      "type": "http",
      "url": "https://agenticfinancegraph.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "afg": {
      "command": "npx",
      "args": ["-y", "github:AgenticFinanceGraph/agentic-finance-graph-mcp", "mcp"]
    }
  }
}

npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp find 57657

I connected Agentic Finance Graph (AFG). Look through what it offers and show me what we can do with it.

Source and CLI on GitHubOfficial MCP RegistryGlama

Apache-2.0, no dependencies. In the official registry as com.agenticfinancegraph/agentic-finance-graph, with the publisher verified by our domain.

Works with your wallet

The ledger holds no keys and moves no money; your agent's wallet does. These recipes put a wallet an agent can pay from and this server in the same client, so the agent can check the other side before it pays. Every command was read from the wallet's own documentation or package on the date given. Nothing here is a partnership or an endorsement, and nothing is claimed about those products beyond what their pages say. Our side is the same each time: the address in card 1, the stdio bridge in card 5, or the afg command line.

The rule to give your agent, in its instructions:

Before any payment to an AI agent or to an address you were given, call pay_check (for an agent) or payee_facts (for an address) on Agentic Finance Graph. If refuse_conditions_met is not empty, do not pay; tell me which condition and show the evidence. If the agent is not ranked, say so: unknown is not bad, but it has no payment history we can see.

npx @coinbase/payments-mcp

claude mcp add agentcash --scope user -- npx -y agentcash@latest

npm install -g @circle-fin/cli
circle wallet login [email protected]
circle wallet list --type agent --chain BASE

npm i -g @alchemy/cli@latest
alchemy auth
alchemy wallet connect --mode session

git clone https://github.com/fireblocks/x402-agent
cd x402-agent && npm install && cp .env.example .env && npm run build

import { makeGateHook } from "agentic-finance-graph-mcp/bin/x402-gate-hook.mjs";
client.onBeforePaymentCreation(makeGateHook({ agent: "57657", policy_name: "recommended-v3", abortOn: ["block"] }));

agentcore add gateway-target --gateway MyGateway --name afg --endpoint https://agenticfinancegraph.com/mcp
agentcore deploy

A wallet missing here is not a wallet that does not work: anything with an MCP client or an x402 client can do the same. Tell us what you run and we will read its documentation: contact.

Ready-made prompts

The server also offers five prompts. In Claude they appear in the prompt menu once the connector is added; pick one and fill in an agent id where asked.

• Start here. A guided tour with today's real figures: what the ledger measures and the questions worth asking it.
• Daily brief. What moved in the last 24 hours: rank, spending and new detections, each figure with its time and definition.
• Check before paying. An agent's statement, level and flags, and who has paid the address you are about to pay. It refuses on a stale statement, a broken chain or open flags.
• Explain an agent. One agent in plain words: its level and why, what it paid and to whom, and what the data cannot show.
• Where agents pay. The endpoints the most ranked agents pay, with counts.

What you can ask

Type any of these into a connected client. Each one was run against the live server on 11 or 12 October 2026 (the last three on 30 October 2026), and the tool your AI calls is shown under it. Put your own agent ids and addresses where ours are.

The tools

What is free and what costs money

Everything the MCP server returns is free. Dated evidence packs about one agent (liveness, payment graph, drain check, incidents, peers, a bundle, a live re-probe, its statement history) or about one receiving address (who paid it) cost 1 to 30 cents in USDC on Base and are bought over x402 at /check/<kind>: the endpoint answers 402 with the exact price, and your client retries with a signed payment. A Desk plan includes every pack. All prices →

For machines

• Endpoint: POST https://agenticfinancegraph.com/mcp (JSON-RPC 2.0; protocol versions 2025-06-18, 2025-03-26, 2024-11-05; JSON responses, no SSE stream).
• The same data as JSON: /api/state, /api/agents, /api/detections, /api/def, OpenAPI, llms.txt.
• Every figure carries a definition id: call definition before quoting a number, and quote the time it was measured.

Quickstart: check an agent before your agent pays it (5 minutes, free)

1. Connect. Add https://agenticfinancegraph.com/mcp to your client (Streamable HTTP, no key, read-only). In Claude: Settings → Connectors → Add custom connector → paste the URL.
2. Call pay_check from any shell:

   curl -s -X POST https://agenticfinancegraph.com/mcp \
     -H "content-type: application/json" -H "accept: application/json, text/event-stream" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pay_check","arguments":{"agent":"57657"}}}'

3. Read the answer. level is the rung on the ladder (L7 paid someone, L8 also funded, L9 repeat independent counterparties); open_incidents lists live harm-shaped detections; statement is the latest signed three-hour statement (age_hours, stale, chain_ok, flags); detections_72h and token_approvals show recent detections and unlimited approvals. The decision stays with your client: we report facts and which refuse conditions are met, never "safe".
4. Common answers. An unranked agent has no record: we have not seen it pay, which is not an accusation. A stale statement means the agent's window is not published yet; read age_hours. GET /mcp answers 405 because MCP needs POST.
5. Next. gate_check applies your own payment policy (AP2 vocabulary) and answers block, warn, log or allow with every reason; payee_facts checks the address you were given.

Questions people actually ask