Agentic Finance Graph

com.agenticfinancegraphv1.1.0Updated Oct 6, 2026

Independent ledger of AI-agent money on Base: ranked agents, payments, detections, statements

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Read-only access to an independent ledger of AI-agent money on Base: ranked agents, payments, detections, metric histories and statements.

What it does
Exposes tools such as market_state, find_agent, agent_record, ranked_agents, detections, definition, metric_history, since_last, counterparty_preview, agent_statement and evidence_pack_quote. Each figure carries a value, unit, measurement time and definition id, and statements are hash-chained and provable against a signed Merkle root. A CLI mirrors the same queries from a terminal.
When to use it
Useful when an assistant needs to look up which AI agents on Base actually pay, check an agent's payment record or detections, compare a metric over 24h to 90d, or verify an agent statement before paying. It is a read-only reference source, not a payment or trading tool.
Requirements
A remote Streamable HTTP endpoint at the provider's /mcp path, stateless and with no key. Clients that only speak stdio can run the published npm package via npx, which needs Node 18 or newer and forwards JSON-RPC to the remote endpoint. Network access is required.
Before you install
The server is described as read-only and free, and nothing in it can move funds. The evidence_pack_quote tool returns the price and URL of a paid evidence pack, quoted at 1 to 25 cents in USDC over x402, but does not pay it; any purchase would be a separate action. Figures are third-party data and should be checked against their definition ids before being quoted.

Installation

In SourceWeft

  1. Open Agentic Finance Graph in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentic-finance-graph": {
      "type": "http",
      "url": "https://agenticfinancegraph.com/mcp"
    }
  }
}

README

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)

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.

Tools

ToolWhat it returns
market_stateHeadline figures, each with value, unit, measurement time and definition id
find_agentOne agent by token id, slug or wallet: rank, wallet, float, payment totals
agent_recordThe free record of a ranked agent, with its 25 newest payments
ranked_agentsTop ranked agents (L7+), optionally from a minimum level
detectionsNewest detections, optionally for one agent
definitionA frozen metric definition: method, exclusions, what it does not claim
metric_historyOne metric over 24h, 7d, 30d or 90d
since_lastOne figure beside the stored sample it moved from (previous sample, 24h, 7d or 30d); no prior sample is a gap, never a zero
counterparty_previewWho paid a receiving address: counted payments, distinct payers, distinct L7+ payers (counts only)
agent_statementAn agent's latest 3-hour statement, hash-chained and provable against a signed Merkle root: check it before you pay
evidence_pack_quotePrice 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 statenpx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp find 57657npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp ranked 10 9npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp history actors_l7_plus 30dnpx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp since actors_l7_plus 24hnpx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp payers 0x4cd00e387622c35bddb9b4c962c136462338bc31npx -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

[Plugin Security Scan]

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 · [email protected] · 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.

Source: README.md at commit 6852f85

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.1.0LatestOct 6, 2026