Agentic Finance Graph
Ledger of AI-agent money on Base: ranked agents, payments, detections, free checks before you pay
One address for any MCP client. No sign-in needed on this server.
What it does
3 read8 other
Grouped by tool name. At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Tools
11 · grouped by tool name · checked 7 Oct 2026Read · 3Look things up
- find_agent
- counterparty_preview
- evidence_pack_quote
Other · 8Neither hinted nor named
- market_state
- agent_record
- ranked_agents
- detections
- definition
- metric_history
- since_last
- agent_statement
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
Listed in: the official MCP Registry as com.agenticfinancegraph/agentic-finance-graph (publisher verified by domain) · Smithery · Glama (health-checked) · the paid evidence packs in the Coinbase x402 Bazaar and on x402scan
The same data on the website (30 seconds)
https://github.com/user-attachments/assets/ee95c1e9-54c2-49fc-b756-5ab58203861d
The Desk at agenticfinancegraph.com/desk: connect a wallet, watch any agent, see its history, request the data for 1 cent. The MCP tools below read the same ledger.
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.
Or run the same bridge in a container (the image holds only the bridge; every answer still comes from the remote endpoint):
docker build -t afg-mcp https://github.com/AgenticFinanceGraph/agentic-finance-graph-mcp.git
docker run -i --rm afg-mcp
Tools
| Tool | What it returns |
|---|---|
market_state | Headline figures, each with value, unit, measurement time and definition id |
find_agent | An agent by token id, slug, wallet or declared name, or up to 25 ids at once: rank (and when it last changed), age, wallet, float, payment totals, open incidents |
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, filtered by agent, kind, severity, time or live incidents only |
definition | A frozen metric definition: method, exclusions, what it does not claim |
metric_history | One metric over 24h, 7d, 30d or 90d, with its own definition, our dated changes inside the range and the date from which it compares |
list_metrics | Every metric we measure: key, unit, definition id, first stored sample, comparable_since |
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 |
pay_check | One free call before paying an agent: statement freshness and chain, live incidents, detections in the last 72 hours, the token approvals its wallet has given (unlimited ones, and any to a plain account), last payment, payments since the statement, and which refuse conditions are met. Facts, never a verdict |
payer_set | The wallets observed paying one agent (up to 250), and how much of its ERC-8004 feedback came from wallets that paid it first. The list is ready to pass to the Reputation Registry's getSummary as clientAddresses |
evidence_pack_quote | Price and URL of a paid evidence pack (1 to 25 cents in USDC over x402); it does not pay. precheck (5 cents) is the routine check before you pay or hire an agent, and takes payto, the address you were given; venue (3 cents) says what one address is; builders (1 cent) lists the ERC-8021 Builder Codes on an agent's payments |
market_state, ranked_agents and agent_record also return typed results (structuredContent, described by an outputSchema). market_state carries a composition block (what counted spending consists of, ten parts that add up to the cent) and our data-quality checks; every figure that our own coverage changes touched carries comparable_since, and the dated register of those changes is at /api/changepoints. The server speaks MCP 2025-11-25 and the earlier versions.
Just connected? Tell your AI, in your own words: "I connected Agentic Finance Graph. Look through what it offers and show me what we can do with it." The server's instructions tell it how to give the tour with today's figures. Three resources are also served: afg://guide, afg://changepoints, afg://definitions.
Prompts
Ready-made workflows. Clients such as Claude show them in the prompt menu once the server is connected.
| Prompt | What it does |
|---|---|
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 id |
check_before_paying (agent, optional payto) | The routine check before your agent pays or hires another: its statement, level and flags, and who has paid the address you were given. It refuses on a stale statement, a broken chain or open flags, and never pays without your approval |
explain_agent (agent) | One agent in plain words: its level and why, what it paid and to whom, its flags, and what the data cannot show |
where_agents_pay | The endpoints the most ranked agents pay, with counts |
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
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp quote precheck 53008 0x0e84ddedaae6a779c462c22a59f301ec31b6b808
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/contactwith{kind, message, reply_to}.
X @AgenticGraph · Telegram · agenticfinancegraph@proton.me · ERC-8004 agent #95875 on Base
Agent skill: check an agent before paying it
A skill file for assistants and agent frameworks that already speak Agent Skills (Claude Code, Cursor, Codex, OpenClaw and the rest): skills/afg-check-agent/SKILL.md. It tells the assistant how to use this MCP server before money moves: find the agent, read its record and its signed three-hour statement, read the detections on it and the counterparty it is about to pay, and report evidence with definitions and measurement times, never a verdict.
npx skills add AgenticFinanceGraph/agentic-finance-graph-mcp --skill afg-check-agent
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.
