Agentic Finance Graph — MCP server and CLI

Ask the independent ledger of machine money directly from Claude, Cursor, an agent framework or your terminal: which AI agents on Base actually pay, how much of their money was really spent, any agent's record, detections, metric histories and the price of an evidence pack.

Read-only and free. Nothing here can move funds, and nothing here needs a key.

Website: agenticfinancegraph.com · Setup guide: MCP server, step by step · Definitions: every figure, defined

Connect as a remote MCP server (recommended)

Endpoint: https://agenticfinancegraph.com/mcp (Streamable HTTP, stateless, no key).

• Claude Code: claude mcp add --transport http afg https://agenticfinancegraph.com/mcp
• Cursor, Windsurf, VS Code and other clients: add a remote MCP server with that URL.

Clients that only speak stdio (Claude Desktop and others)

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

The mcp command forwards each JSON-RPC message to the remote endpoint. It has no dependencies; Node 18 or newer is enough.

Tools

Tool	What it returns
market_state	Headline figures, each with value, unit, measurement time and definition id
find_agent	One agent by token id, slug or wallet: rank, wallet, float, payment totals
agent_record	The free record of a ranked agent, with its 25 newest payments
ranked_agents	Top ranked agents (L7+), optionally from a minimum level
detections	Newest detections, optionally for one agent
definition	A frozen metric definition: method, exclusions, what it does not claim
metric_history	One metric over 24h, 7d, 30d or 90d
since_last	One figure beside the stored sample it moved from (previous sample, 24h, 7d or 30d); no prior sample is a gap, never a zero
counterparty_preview	Who paid a receiving address: counted payments, distinct payers, distinct L7+ payers (counts only)
agent_statement	An agent's latest 3-hour statement, hash-chained and provable against a signed Merkle root: check it before you pay
evidence_pack_quote	Price and URL of a paid evidence pack (1 to 25 cents in USDC over x402); it does not pay

CLI

npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp state
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp find 57657
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp ranked 10 9
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp history actors_l7_plus 30d
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp since actors_l7_plus 24h
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp payers 0x4cd00e387622c35bddb9b4c962c136462338bc31
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp statement 53008

Or install it once: npm install -g github:AgenticFinanceGraph/agentic-finance-graph-mcp, then run afg state.

How the numbers are counted

Every figure carries its definition id and the time it was measured. Call definition before quoting one, or read them all at agenticfinancegraph.com/def. A figure that turns out wrong is corrected publicly, with a date, in the changelog.

Security

Every push and pull request is scanned by the HOL AI Plugin Scanner, pinned to an exact commit and run with read-only permissions. Dependabot watches the workflow's actions. The package has no dependencies, and the server it talks to is read-only: nothing here can move funds. Found a problem? See SECURITY.md. What changed and when: CHANGELOG.md.

Work with us

• Builders: see where we need help — MCP clients, framework adapters, a Python client, recipes. We are open to people who want to join the founding team.
• Platforms, institutions and investors: agenticfinancegraph.com/contact
• Agents: POST https://agenticfinancegraph.com/api/contact with {kind, message, reply_to}.

X @AgenticGraph · Telegram · agenticfinancegraph@proton.me · ERC-8004 agent #95875 on Base

Licence

Apache-2.0 for the code in this repository. The data served by the endpoint is Agentic Finance Graph's; quote it with the definition id and the measurement time.