Agentic Finance Graph

Official11 tools

by AgenticFinanceGraph · JavaScript

Ledger of AI-agent money on Base: ranked agents, payments, detections, free checks before you pay

Agentic Finance Graph MCP Server

The MCP server described by com.agenticfinancegraph/agentic-finance-graph provides an “independent ledger of AI-agent money on Base.” Its scope is centered on ranked agents, payments, detections, and generated statements, as indicated by the server description.

🛠️ Key Features

Independent ledger of AI-agent money on Base
Ranked agents
Payments tracking
Detections
Statements

🚀 Use Cases

Tracking payments associated with AI agents on Base
Recording detections alongside agent activity
Producing statements from ledger data
Maintaining a ranked view of agents

⚡ Developer Benefits

Clear entity categories implied by the description: agents, payments, detections, statements
Focused data model for Base-based agent finance records

⚠️ Limitations

Available details do not specify tool count, supported MCP tools, authentication, or API endpoints

Topics

agent-paymentsagentic-financeai-agentsbaseerc-8004mcpmcp-servermodel-context-protocolonchain-analyticsstablecoinsusdcx402

Captured live from the server via tools/list.

market_state

The ledger's headline figures for AI-agent money, each with its value, unit, measurement time and definition id. On Base: money agents paid to others after registration (counted), daily spending by the day it was paid (last day, 7-day and 30-day averages), the part that went into positions they still hold, what left their control, the routing hops and pre-registration history excluded, how many agents are ranked (L7+ paid someone, L8 funded, L9 repeat counterparties), agent income, x402 seller inflow, treasuries, concentration, detections and the address-poisoning watch. On other chains: ERC-8004 registrations on seven chains, what registration owners paid on BNB Smart Chain, Ethereum, Arbitrum, OP Mainnet and Polygon, and Solana agent registrations and payments.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

find_agent

Look up one ERC-8004 agent by token id on Base, slug, or wallet address (0x...). Returns whether it is ranked, its liveness level (L0-L9), bound wallet, stablecoin float, payment totals and open incidents.

Parameters1

query

string

required

Token id (e.g. 57657), slug (8004-base-57657) or wallet address (0x...)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token id (e.g. 57657), slug (8004-base-57657) or wallet address (0x...)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

agent_record

The free record of one ranked agent: rank with evidence, bindings, and its 25 newest payments with counterparties. Unranked ids return not found: an agent never seen paying has no record to sell or show.

Parameters1

string

required

Token id, slug or wallet address

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Token id, slug or wallet address"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

ranked_agents

The top ranked agents (L7 and above: a bound wallet was seen paying a different address after registration), sorted by the ledger's default order. Free tier: up to 25.

Parameters2

limit	integer	optional
min_level	integer	optional	Only agents at or above this liveness level

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    },
    "min_level": {
      "type": "integer",
      "minimum": 7,
      "maximum": 9,
      "description": "Only agents at or above this liveness level"
    }
  },
  "additionalProperties": false
}

detections

Anomalies our detectors logged, newest first: drain-shaped payments, retry storms, mint bursts, owner changes under a binding, delegation to unknown code. A detection is a shape with evidence, never a verdict. Optionally for one agent.

Parameters2

agent	string	optional	Optional agent id (act_8453_N or token id)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "description": "Optional agent id (act_8453_N or token id)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "additionalProperties": false
}

definition

The frozen definition of a metric: what it counts, the method, what it excludes and what it does not claim. Use the definition ids returned by the other tools.

Parameters1

string

required

Definition id, e.g. pay.usd.total.v1

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Definition id, e.g. pay.usd.total.v1"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

metric_history

The history of one measured metric from the ledger's archive (daily points, plus 5-minute points for the last 48 hours). Gaps are real gaps, never filled. An unknown key returns similar keys and the full list of archived keys.

Parameters2

key	string	required	Metric key, e.g. actors_l7_plus or observed_pay_usd_total
range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Metric key, e.g. actors_l7_plus or observed_pay_usd_total"
    },
    "range": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d"
      ],
      "default": "30d"
    }
  },
  "required": [
    "key"
  ],
  "additionalProperties": false
}

since_last

One measured figure with the stored sample it moved from: current, prior, delta, delta_ratio, both timestamps, definition id, unit, and whether the move is material under the published thresholds. window: sweep (the previous stored sample, the default), 24h, 7d or 30d. No prior sample inside the window returns gap: true and no delta; nothing is interpolated. Accepts a metric key or a definition id.

Parameters2

metric_id	string	required	Metric key (actors_l7_plus) or definition id (rank.l7plus.v1)
window	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "metric_id": {
      "type": "string",
      "description": "Metric key (actors_l7_plus) or definition id (rank.l7plus.v1)"
    },
    "window": {
      "type": "string",
      "enum": [
        "sweep",
        "24h",
        "7d",
        "30d"
      ],
      "default": "sweep"
    }
  },
  "required": [
    "metric_id"
  ],
  "additionalProperties": false
}

counterparty_preview

For one receiving address on Base (or an x402 resource URL listed in the Bazaar): how many counted payments registered agents made into it, how many distinct agents and how many at L7 or above, first and last seen, and the routing hops excluded. Counts only; the payer list with levels, binding confidence and transaction hashes is the counterparty pack. An address that only received routing hops is not a payee. Without an address: the endpoints the most ranked agents pay.

Parameters1

address

string

optional

0x address on Base, or an x402 resource URL; omit for the top endpoints

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "0x address on Base, or an x402 resource URL; omit for the top endpoints"
    }
  },
  "additionalProperties": false
}

agent_statement

The latest 3-hour statement for one ranked agent: payments out split into spend, routing hops and payments whose receipt is not read yet; what left its control; income; open flags; the hash of the previous statement; and a Merkle proof against the window's Ed25519-signed root. Check before you pay: refuse if stale, if chain_ok is false, or if flags is not empty.

Parameters1

string

required

Agent token id, slug or bound wallet

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Agent token id, slug or bound wallet"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

evidence_pack_quote

Price and how to buy a dated evidence pack over x402 (USDC on Base). About one agent: liveness, paygraph (where it pays), drain, incidents, peer, bundle, reval (a live re-probe) or statement (its last 24 statements with proofs). About one receiving address: counterparty (which ranked agents paid it). This tool does not pay; an x402-capable client fetches the returned URL, receives HTTP 402 with the exact price, and retries with a signed payment.

Parameters2

kind	string	required
id	string	required	Agent token id, slug or wallet; for counterparty, the receiving 0x address

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "liveness",
        "paygraph",
        "drain",
        "incidents",
        "peer",
        "bundle",
        "reval",
        "statement",
        "counterparty"
      ]
    },
    "id": {
      "type": "string",
      "description": "Agent token id, slug or wallet; for counterparty, the receiving 0x address"
    }
  },
  "required": [
    "kind",
    "id"
  ],
  "additionalProperties": false
}

README.md11 KBView on GitHub

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)

json

{
  "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):

bash

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`
`agent_stability`	Stable for N days: complete UTC days since the last break in an agent's own payment behaviour (a CUSUM against its own history), the last break, and its 30-day heartbeat (scheduled, irregular, bursty, sparse). A break is a change, not a harm; the measured false-break rate is published
`agent_independence`	Whether an agent's rank rests on demand outside its own operator set: the seed-based best-path score, its L9 support under the published and the operator-set-aware rule, the inflation ratio, and the size of its operator set
`ladder_dynamics`	How ranked agents end (cumulative incidence of drained, abandoned, dormant with numbers at risk), the drain ratio per launch platform with intervals, the day-to-day transition matrix, and the landmark re-check of the survival figures
`verify_sum_log`	The skeptical client: verifies the Ed25519 signature on the Merkle-sum head over every counted payment, climbs one agent's proof to the root and the total, reports what changed since the head you kept, and verifies the statement log's signed head and consistency proof
`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; `exit` (3 cents) lists the windows in which a new payee took most of an agent's outflow, whether it paid anyone after, and where the money went next (candidates under `drain.abandoned.v1`, never verdicts); `trace` (5 cents) follows an agent's exits live up to three hops, with each hop's label, kind, issuer freeze, swap out of a freezable token and Tron activity (`check.trace.v1`)

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. The same read-only checks also answer over A2A (JSON-RPC message/send) at https://agenticfinancegraph.com/api/a2a; the agent card is at /.well-known/agent-card.json.

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

code

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/contact with {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.

bash

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.

Install

Tools (11)

market_statefind_agentagent_recordranked_agentsdetectionsdefinitionmetric_historysince_last

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agenticfinancegraph.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentic-finance-graph": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agenticfinancegraph.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Agentic Finance Graph MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

market_state

find_agent

agent_record

ranked_agents

detections

definition

metric_history

since_last

counterparty_preview

agent_statement

evidence_pack_quote

Agentic Finance Graph — MCP server and CLI

The same data on the website (30 seconds)

Connect as a remote MCP server (recommended)

Clients that only speak stdio (Claude Desktop and others)

Tools

Prompts

CLI

How the numbers are counted

Security

Work with us

Agent skill: check an agent before paying it

Licence

Install

Remote endpoint

Related servers