Agentic Finance Graph

Agentic Finance Graph — MCP 服务和 CLI

直接向 Claude、Cursor、Agent 框架或终端询问独立的机器资金账本：Base 上哪些 AI Agent 确实在付款、实际花掉了多少钱、任意 Agent 的记录、检测结果、指标历史，以及证据包的价格。

只读且免费。这里的任何内容都无法转移资金，也不需要密钥。

网站： agenticfinancegraph.com · 设置指南： MCP 服务，分步说明 · 定义： 每个数值的定义

收录于： 官方 MCP Registry，名称为 com.agenticfinancegraph/agentic-finance-graph（发布者已通过域名验证）· Smithery · Glama（已进行健康检查）· Coinbase x402 Bazaar 和 x402scan 上的付费证据包

在网站上查看相同数据（30 秒）

https://github.com/user-attachments/assets/ee95c1e9-54c2-49fc-b756-5ab58203861d

访问 agenticfinancegraph.com/desk 中的 Desk：连接钱包、关注任意 Agent、查看其历史记录，并以 1 美分获取数据。以下 MCP 工具读取的是同一份账本。

连接为远程 MCP 服务（推荐）

端点：https://agenticfinancegraph.com/mcp（Streamable HTTP，无状态，无需密钥）。

• Claude Code： claude mcp add --transport http afg https://agenticfinancegraph.com/mcp
• Cursor、Windsurf、VS Code 和其他客户端： 使用该 URL 添加远程 MCP 服务。

仅支持 stdio 的客户端（Claude Desktop 等）

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

mcp 命令会将每条 JSON-RPC 消息转发到远程端点。它没有依赖项；只需 Node 18 或更高版本。

也可以在容器中运行相同的桥接程序（镜像中只有桥接程序；所有答复仍来自远程端点）：

docker build -t afg-mcp https://github.com/AgenticFinanceGraph/agentic-finance-graph-mcp.git
docker run -i --rm afg-mcp

工具

工具	返回内容
market_state	标题数据，每项均包含数值、单位、测量时间和定义 ID
find_agent	按 token ID、slug、钱包或声明名称查找 Agent，或一次查找最多 25 个 ID：排名（以及最近一次变化时间）、存续时间、钱包、流通量、支付总额、未结事件
agent_record	排名 Agent 的免费记录，包含最新的 25 笔支付
ranked_agents	排名最高的 Agent（L7+），可选择最低等级
detections	最新检测结果，可按 Agent、类型、严重程度、时间或仅未结事件筛选
definition	冻结的指标定义：方法、排除项、不声称的内容
metric_history	某项指标在 24h、7d、30d 或 90d 内的历史，包含其定义、我们在该范围内的日期变更，以及用于比较的起始日期
list_metrics	我们测量的所有指标：键、单位、定义 ID、首个存储样本、comparable_since
since_last	将一个数值与其所依据的存储样本并列显示（前一个样本、24h、7d 或 30d）；没有先前样本表示数据缺口，绝不表示为零
counterparty_preview	向某个收款地址付款的人：计数的支付笔数、不同付款方数量、不同 L7+ 付款方数量（仅计数）
agent_statement	Agent 最新的 3 小时声明，采用哈希链保护，可通过已签名 Merkle 根验证：付款前请先检查
pay_check	向 Agent 付款前的一次免费调用：声明的新鲜度和链、未结事件、过去 72 小时内的检测结果、其钱包已授权的代币（无限额授权，以及任何授权给普通账户的情况）、最近一笔支付、声明之后的支付，以及满足了哪些拒绝条件。只提供事实，绝不作出判定
payer_set	已观察到向某个 Agent 付款的钱包（最多 250 个），以及其 ERC-8004 反馈中有多少来自先向其付款的钱包。此列表可直接传给 Reputation Registry 的 getSummary，作为 clientAddresses
agent_stability	稳定运行 N 天：自 Agent 自身支付行为上次中断以来完整经过的 UTC 天数（根据其自身历史进行 CUSUM 检测）、上次中断时间，以及其 30 天心跳模式（定时、不规律、突发、稀疏）。中断表示变化，并不表示伤害；已公布测得的误报率
agent_independence	Agent 的排名是否依赖其自身运营方集合以外的需求：基于种子的最佳路径得分、按已发布规则和运营方集合感知规则计算的 L9 支持度、膨胀比率，以及其运营方集合的规模
ladder_dynamics	排名 Agent 如何终止（耗尽、弃用、休眠的累积发生率及风险人数）、各启动平台的耗尽比率及区间、每日转移矩阵，以及对生存数据的里程碑复查
verify_sum_log	面向持怀疑态度的客户端：验证覆盖所有计数支付的 Merkle-sum 头部的 Ed25519 签名，沿单个 Agent 的证明逐级验证到根和总额，报告自你保存的头部以来发生的变化，并验证声明日志的已签名头部和一致性证明
agent_pattern	影子模式，自 2026 年 10 月 16 日起：Agent 最新的计数支付是否符合其行为模式（behaviour.out_of_character.v2）：等级为 none / notable / major，并列出触发的原因、其过去 30 天内有多少支付参与评分，以及市场比率。等级只是供人阅读的模式提示，绝非判定；不会因此拦截任何内容
payee_facts	关于 Agent 即将付款的地址的七项测量事实（payee.facts.v1）：代码类型及任何已知的扫币委托合约、转发器形态、换成不可冻结资产的兑换、资金来源及流向、凭证明相关选择器、发行方冻结状态、向其付款的注册 Agent 数量；结合付款 Agent 和金额，判断它是否是一个以新金额首次付款的目的地，或是否与 Agent 历史中的地址相似。每项事实均包含数值、证据、方法和时间；无法获取的渠道会明确说明，绝不猜测
gate_check	仅记录：此 Agent 现在能否向此地址支付此金额？包含收款方事实、我们账本中该 Agent 自身的上下文（仅用过去的数据，绝不使用调用方提供的数据）、该笔支付的偏离行为等级，以及按 AP2 mandate 词汇（allowed_payees、amount_range、budget、agent_recurrence、execution_date；我们的词汇：new_payee、refuse_conditions、signal）制定的策略给出的决定，并记录每一项原因：block / warn / log / allow。未知约束按失败关闭处理。命名策略：log-only（默认）、balanced、recommended、recommended-v3、strict。我们绝不会拦截任何内容；由你的客户端决定，并自行决定其失败模式
agent_pass	Agent Pass（agent.pass.v2）：在某一时点对 Agent 进行的八项检查，有效期三小时——等级 L7+、无未结伤害类事件、过去 30 天内有一笔计数支付、最新支付符合行为模式、无发行方冻结、无授予普通密钥的无限额授权、过去 90 天内无伤害类事件、过去一个月行为符合模式。无论是否满足条件，都会列出未通过项、无法检查的项目（列出，绝不写成 0）以及发行方公钥。影子模式：在解除影子模式前不签名。绝不表示安全、已验证或可信
blast_radius	如果某个密钥被盗，在一个区块内会造成的影响（agent.blast_radius.v1）：定价后的余额和 ETH、EIP-7702 委托合约及任何已知扫币家族、链上确认且以上限不超过余额计算的未结授权。等级 L8 或以上的 Agent，每六小时读取一次
canary_register、canary_status	供已登录的运营方使用（请求时发送 Authorization: Bearer <Desk session>）：注册你布置的诱饵的公开部分（永不持有余额的诱饵密钥、地址、URL 哈希、API 密钥哈希、工具名称、付费资源），并读取你的 canary 状态及触发记录（canary.trigger.v1）。验证前即会拒绝私密材料；绝不公开任何关于诱饵布置的信息
evidence_pack_quote	付费证据包的价格和 URL（通过 x402 支付 1 至 25 美分的 USDC）；此工具不会付款。precheck（5 美分）是付款或聘用 Agent 前的常规检查，接收你获得的地址 payto；venue（3 美分）说明一个地址的性质；builders（1 美分）列出 Agent 支付中包含的 ERC-8021 Builder Codes；exit（3 美分）列出新收款方收取 Agent 大部分资金流出的时间窗口、之后是否有付款，以及资金后续去向（drain.abandoned.v1 下的候选项，绝非判定）；trace（5 美分）实时追踪 Agent 的资金流出，最多三跳，列出每跳的标签、类型、发行方冻结状态、从可冻结代币兑换出去的情况和 Tron 活动（check.trace.v1）
market_state、ranked_agents 和 agent_record 也会返回类型化结果（structuredContent，由 outputSchema 描述）。market_state 包含一个 composition 区块（说明计入的支出由什么组成，共十个部分，合计精确到分），以及我们的数据质量检查；我们自身覆盖范围的变更影响到的每个数值都带有 comparable_since，这些变更的日期登记表位于 /api/changepoints。该服务支持 MCP 2025-11-25 及更早版本。同样的只读检查也可通过 A2A（JSON-RPC message/send）在 https://agenticfinancegraph.com/api/a2a 上响应；Agent 卡片位于 /.well-known/agent-card.json。

刚刚连接？ 用你自己的话告诉 AI：“我已连接 Agentic Finance Graph。看看它提供了什么，并告诉我能用它做什么。” 服务的说明会告诉它如何结合今天的数据进行介绍。它还提供三个资源：afg://guide、afg://changepoints、afg://definitions。

提示词

现成的工作流。连接服务后，Claude 等客户端会在提示词菜单中显示这些工作流。

提示词	功能
start_here	结合今天的真实数据进行介绍：账本衡量什么，以及值得向它提出哪些问题
daily_brief	过去 24 小时发生了哪些变化：排名、支出和新检测结果，每个数值都附有时间和定义 ID
check_before_paying（agent，可选 payto）	Agent 付款或雇用其他 Agent 前的常规检查：其声明、等级和标记，以及谁曾向你提供的地址付款。如果声明已过期、链条中断或存在未处理的标记，则拒绝通过；未经你批准，绝不付款
explain_agent（agent）	用通俗语言介绍一个 Agent：它的等级及原因、它支付了什么以及收款对象、它的标记，以及数据无法显示的内容
where_agents_pay	排名最高的 Agent 付款最多的端点及其次数

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
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp verify 45978
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp chaincheck 57067
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp logwatch
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp pattern 57657
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp facts 0x424b266c22509a9eb47bcb5b908f40c1157cc2a1 45978 100
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp gate 45978 0x424b266c22509a9eb47bcb5b908f40c1157cc2a1 100 recommended-v3
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp pass 57657
npx -y github:AgenticFinanceGraph/agentic-finance-graph-mcp blast 57657

安全层（自 2026 年 10 月 16 日起处于影子模式）

Agent 付款前的检查（gate_check、payee_facts）、付款后的监控（agent_pattern）、对测量结果进行的三小时签名声明（agent_pass）、密钥被盗后可能造成的影响（blast_radius），以及植入的诱饵（canary_register、canary_status）。所有测量均来自链和账本，绝不依据 Agent 自己的说法；每个答复都附有测量时间和定义 ID；这些都不是判决，在影子模式下也不会拦截或发出警报。查看工作原理及实时数据：agenticfinancegraph.com/security。

x402 客户端的 Gate 钩子

bin/x402-gate-hook.mjs 是供 @x402/core 2.x 客户端使用的 onBeforePaymentCreation 钩子。在方案签名之前，它会根据你的 Agent、收款方、待签金额的 USD 价值及你的策略，调用 gate_check，并在遇到你选择的判定时中止。默认仅在判定为 block 时中止；如果无法连接 AFG，则允许并记录警告（onUnavailable: "warn"）；"abort" 会失败关闭，"allow" 会失败开放。没有依赖项；已通过替代服务器测试（npm test）。

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

该钩子会为 Base 上的 USDC、USDT 和 DAI 定价；其他资产和网络也允许使用，并会记录为未检查。Gate 阻止的支付只会在你的客户端中被阻止，绝不会在我们这里被阻止：AFG 会记录判定，但不会转移任何资金。

afg verify <agent-id> 不信任任何未经重新计算验证的内容：它会获取 Merkle-sum 日志（sumlog.v1）的已签名头部和 Agent 的证明，重建叶子及其到 head.agent_root 的路径，检查求和金额是否等于完整的计入总额，并验证头部上的 Ed25519 签名。每项检查输出一行；任何检查失败时，退出代码为 1。设置 AFG_SUMLOG_PUBKEY，填入通过带外方式提供给你的 32 字节十六进制密钥，以免信任答案中打印的密钥。

afg chaincheck <agent-id> 会通过我们未运行的公共 Base RPC（默认使用 https://mainnet.base.org；设置 AFG_BASE_RPC 可使用你自己的 RPC），直接在链上核验 Agent 的免费记录。它会读取铸造交易（铸造到指定账户，时间为指定时间），为每个开放绑定调用注册表（ownerOf、getAgentWallet；铸造账户绑定必须等于注册铸造到的账户），并读取记录资金路径中每笔支付的回执：支付必须是一次成功的 USDC、USDT、EURC 或 DAI 转账，依据合约地址判断，转账方为 Agent 绑定的钱包之一，收款方及金额与指定信息一致，且发生在注册之后。每项声明输出一行；RPC 未返回的声明会显示为未读取，而不会显示为通过；如果任何从链上读取的声明不成立，退出代码为 1。

afg editioncheck <period> 用于读者核验某一期 State of Agent Money（2026-09，或 2026-Q4 这样的季度版）。它会获取该期文件，确认其 SHA-256 值与声明日志中提交的哈希一致；根据 ERC-8004 Identity Registry 在该期首块和末块的状态，重新推导该期铸造的注册数量及期末总数（Agent ID 按顺序递增，因此在某个区块上能通过 ownerOf 查询的最高 ID 就是总数；使用我们未运行的公共 Base RPC，设置 AFG_BASE_RPC 可使用你自己的 RPC）；并检查该期引用的每个定义 ID 是否都能解析。此处不会重新推导计入的支付，因为这需要账本的绑定集合；afg chaincheck <agent> 可对单个 Agent 执行此操作。任何检查失败时，退出代码为 1。

afg logwatch [state-file] 是用于监控声明日志的外部监控工具（记录每个已签名的 3 小时声明根的 RFC 6962 树）。运行一次后让它持续运行；每天通过 cron 运行一次即可。

• **每次运行：**检查当前已签名树头上的 Ed25519 签名。
• **后续运行：**从上次保存的树头获取一致性证明，并按 RFC 9162 方式验证。
• **证明失败：**意味着已发布的历史记录被改写。树缩小或签名密钥变更也会被报告。
• **树头保存位置：**默认位于 ~/.afg-statement-log.json。AFG_LOG_PUBKEY 用于固定密钥。

也可以一次性安装：npm install -g github:AgenticFinanceGraph/agentic-finance-graph-mcp，然后运行 afg state。

数字的统计方式

每个数据都附有其定义 ID 和测量时间。引用数据前请先调用 definition，或在 agenticfinancegraph.com/def 查看全部定义。如果发现数据有误，我们会在 changelog 中公开更正并注明日期。

安全

每次推送和拉取请求都会由 HOL AI Plugin Scanner 扫描，该扫描器固定到精确的提交版本，并以只读权限运行。Dependabot 会监控工作流中的操作。此软件包没有依赖项，它所连接的服务也是只读的：这里的任何内容都无法转移资金。发现问题？请参阅 SECURITY.md。变更内容及时间：CHANGELOG.md。

与我们合作

• **构建者：**查看我们需要哪些帮助——MCP 客户端、框架适配器、Python 客户端和操作指南。欢迎有意加入创始团队的伙伴。
• 平台、机构和投资者：agenticfinancegraph.com/contact
• **Agent：**向 https://agenticfinancegraph.com/api/contact 发送 POST 请求，并附上 {kind, message, reply_to}。

X @AgenticGraph · Telegram · [email protected] · Base 上的 ERC-8004 Agent #95875

Agent 技能：付款前检查 Agent

面向已支持 Agent Skills 的助手和 Agent 框架（Claude Code、Cursor、Codex、OpenClaw 等）的技能文件：skills/afg-check-agent/SKILL.md。它会指导助手在资金转移前如何使用此 MCP 服务：查找 Agent，阅读其记录和签名的三小时声明，查看针对该 Agent 及其即将付款对象的检测结果，并附上定义和测量时间报告证据，绝不作出判定。

npx skills add AgenticFinanceGraph/agentic-finance-graph-mcp --skill afg-check-agent

许可证

本仓库中的代码采用 Apache-2.0 许可证。端点提供的数据归 Agentic Finance Graph 所有；引用时请附上定义 ID 和测量时间。