Agentic Finance Graph

Agentic Finance Graph — MCP サーバーと CLI

Claude、Cursor、エージェントフレームワーク、またはターミナルから、独立したマシンマネー台帳に直接質問できます。Base 上で実際に支払いを行っている AI エージェント、実際に使われた金額、任意のエージェントの記録、検出結果、メトリクスの履歴、エビデンスパックの価格を確認できます。

読み取り専用で無料です。ここから資金を移動することはできず、キーも必要ありません。

ウェブサイト： agenticfinancegraph.com · セットアップガイド： MCP サーバーの手順 · 定義： すべての数値の定義

掲載先： com.agenticfinancegraph/agentic-finance-graph として 公式 MCP Registry（ドメインによる発行者確認済み） · Smithery · Glama（ヘルスチェック済み） · Coinbase x402 Bazaar および x402scan の有料エビデンスパック

ウェブサイトで同じデータを確認する（30 秒）

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

agenticfinancegraph.com/desk の Desk：ウォレットを接続し、任意のエージェントをウォッチして、その履歴を確認し、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	トークン ID、スラッグ、ウォレット、または登録名で検索したエージェント、または一度に最大 25 個の ID：ランク（および最後に変動した時期）、経過期間、ウォレット、フロート、支払い合計、未解決インシデント
agent_record	ランク付けされたエージェントの無料記録と、最新の支払い 25 件
ranked_agents	ランク上位のエージェント（L7 以上）。必要に応じて最低レベルを指定できます
detections	エージェント、種類、重大度、時刻、またはライブインシデントのみによる絞り込みが可能な、最新の検出
definition	固定された指標の定義：測定方法、除外事項、主張していない内容
metric_history	24 時間、7 日、30 日、90 日のいずれかの期間における 1 つの指標。独自の定義、期間内の日付付き変更、比較の起点となる日付が含まれます
list_metrics	測定対象のすべての指標：キー、単位、定義 ID、最初に保存されたサンプル、comparable_since
since_last	1 つの数値と、その値が変化する前の保存済みサンプル（前回のサンプル、24 時間前、7 日前、または 30 日前）を並べて表示します。以前のサンプルがない場合は欠損であり、ゼロではありません
counterparty_preview	受取アドレスに支払った相手：集計対象の支払い数、個別の支払者数、L7 以上の個別の支払者数（件数のみ）
agent_statement	エージェントの最新の 3 時間分のステートメント。ハッシュチェーン化され、署名済み Merkle ルートに照らして検証可能です：支払う前に確認してください
pay_check	エージェントに支払う前に行える無料の 1 回の呼び出し：ステートメントの鮮度とチェーン、ライブインシデント、過去 72 時間の検出、ウォレットが行ったトークン承認（無制限のもの、および通常のアカウント宛てのもの）、最後の支払い、ステートメント以降の支払い、該当する拒否条件。事実を示すものであり、判定ではありません
payer_set	あるエージェントへの支払いが確認されたウォレット（最大 250 件）、およびそのエージェントの ERC-8004 フィードバックのうち、先に支払いを行ったウォレットからのものが占める割合。リストは Reputation Registry の getSummary に clientAddresses として渡せる形式です
agent_stability	N 日間の安定性：エージェント自身の支払い動向において、最後に途切れてからの UTC 完全日数（エージェント自身の履歴に対する CUSUM）、最後に途切れた時点、30 日間のハートビート（予定どおり、不規則、集中型、まばら）。途切れは変化であって、害ではありません。測定された誤検出率を公開しています
agent_independence	エージェントのランクが自身の運営者セット以外の需要に支えられているかどうか：シードベースの最良経路スコア、公表ルールおよび運営者セットを考慮したルールに基づく L9 支持度、インフレ率、運営者セットの規模
ladder_dynamics	ランク付けされたエージェントがどのような結果を迎えるか（リスク対象数付きの、資金枯渇、放棄、休眠の累積発生率）、ローンチプラットフォーム別の資金枯渇比率と信頼区間、日ごとの遷移行列、生存率のランドマーク再確認
verify_sum_log	懐疑的なクライアント：集計対象の全支払いを対象とする Merkle-sum ヘッドの Ed25519 署名を検証し、1 つのエージェントの証明をルートおよび合計までたどり、保持していたヘッド以降の変更を報告し、ステートメントログの署名済みヘッドと整合性証明を検証します
agent_pattern	シャドーモード。2026 年 10 月 16 日以降：エージェントの最新の集計対象支払いが、そのエージェントの傾向に沿っているかどうか（behaviour.out_of_character.v2）：該当した理由とともに、レベルは none／notable／major、過去 30 日間の支払いのうちスコア付けされた件数、市場全体の割合を表示します。レベルは人間が確認するパターンであり、判定ではありません。これを理由にブロックされるものはありません
payee_facts	エージェントが支払おうとしているアドレスに関する、測定された 7 つの事実（payee.facts.v1）：コードの種類と既知のスイーパーデリゲート、リレーの形態、凍結不能資産へのスワップ、そのアドレスへの資金提供元と送金先、証明時請求セレクター、発行者による凍結、そのアドレスに支払う登録済みエージェント数。支払い元のエージェントと金額を指定すると、新しい金額での未払い先か、エージェントの履歴にあるアドレスに類似したアドレスかどうかも示します。各事実には値、根拠、測定方法、時刻が含まれます。利用できない情報源は明示し、推測はしません
gate_check	ログのみ：このエージェントは、今、この金額をこのアドレスに支払えるか？受取人の事実、台帳に記録されたエージェント自身のコンテキスト（過去の記録のみ。呼び出し元からは取得しません）、支払いの通常外レベル、AP2 委任の用語に基づくポリシーによる判定（allowed_payees、amount_range、budget、agent_recurrence、execution_date。当方の用語：new_payee、refuse_conditions、signal）を確認し、理由をすべて記録したうえで、ブロック／警告／ログ記録／許可を返します。不明な制約は安全側に倒して拒否します。指定できるポリシーは log-only（デフォルト）、balanced、recommended、recommended-v3、strict です。当方がブロックすることはありません。判断するのはクライアントであり、障害時の動作もクライアント自身が決めます
agent_pass	Agent Pass（agent.pass.v2）：ある時点におけるエージェントの 8 項目の確認結果。有効期間は 3 時間です。確認項目は、レベル L7 以上、害の種類の未解決インシデントなし、過去 30 日間に集計対象の支払いあり、最新の支払いが通常どおり、発行者による凍結なし、通常のキーへの無制限承認なし、過去 90 日間に害の種類のインシデントなし、1 か月間通常どおりであることです。条件を満たしているか、失敗した項目、確認できなかった項目（列挙するだけで、0 として記録することはありません）、発行者の公開鍵を示します。シャドーモード中は、シャドーモードが解除されるまで署名されません。安全、検証済み、信頼できるとは決して示しません
blast_radius	1 ブロック時点で、盗まれたキーによって動かされる資産（agent.blast_radius.v1）：評価額付き残高と ETH、EIP-7702 デリゲートと既知のスイーパーファミリー、オンチェーンで確認され残高を上限とする未解決の使用許可。L8 以上のエージェントが対象で、6 時間ごとに読み取ります
canary_register, canary_status	サインイン済みの運営者向け（リクエストに Authorization: Bearer <Desk session> を指定）：設置したデコイの公開部分を登録し（残高を持つことのないおとりキー、アドレス、URL ハッシュ、API キーのハッシュ、ツール名、有料リソース）、カナリアの状態と発火状況を読み取ります（canary.trigger.v1）。非公開情報は検証前に拒否します。設置に関する情報が公開されることはありません
evidence_pack_quote	有料のエビデンスパックの価格と URL（x402 経由で USDC 1～25 セント）。支払いは行いません。precheck（5 セント）は、エージェントに支払う、または雇う前に行う定型チェックで、payto（教えられたアドレス）を受け取ります。venue（3 セント）は 1 つのアドレスが何であるかを示します。builders（1 セント）は、エージェントの支払いに含まれる ERC-8021 Builder Code を一覧表示します。exit（3 セント）は、新しい受取人がエージェントの資金流出の大部分を受け取った期間、エージェントがその後誰かに支払ったかどうか、次に資金がどこへ移動したかを一覧表示します（drain.abandoned.v1 に基づく候補であり、判定ではありません）。trace（5 セント）は、エージェントの送金先を最大 3 ホップまでリアルタイムで追跡し、各ホップのラベル、種類、発行者による凍結、凍結可能なトークンからのスワップ、Tron 上の活動を表示します（check.trace.v1）
market_state、ranked_agents、agent_record も型付きの結果（outputSchema で定義された structuredContent）を返します。market_state には composition ブロック（集計対象の支出の内訳。10 項目を合計するとセント単位で一致します）とデータ品質チェックが含まれます。独自のデータカバレッジの変更が影響したすべての数値には comparable_since が付き、変更の日時を記録した一覧は /api/changepoints にあります。サーバーは MCP 2025-11-25 とそれ以前のバージョンに対応しています。同じ読み取り専用チェックは、https://agenticfinancegraph.com/api/a2a の A2A（JSON-RPC message/send）経由でも利用できます。エージェントカードは /.well-known/agent-card.json にあります。

接続したばかりですか？ AI に自分の言葉でこう伝えてください。「Agentic Finance Graph に接続しました。利用できる機能を確認して、何ができるか教えてください。」 サーバーの指示に従って、今日の数値を使った概要を案内します。次の 3 つのリソースも提供されています。afg://guide、afg://changepoints、afg://definitions。

プロンプト

すぐに使えるワークフローです。Claude などのクライアントでは、サーバーに接続するとプロンプトメニューに表示されます。

プロンプト	機能
start_here	今日の実数値を使ったガイドツアーです。台帳で測定する対象と、確認する価値のある質問を紹介します
daily_brief	過去 24 時間の変化を確認します。順位、支出、新たな検出結果を、それぞれ時刻と定義 ID とともに示します
check_before_paying（agent、payto は任意）	エージェントが別のエージェントに支払う、または雇う前の定型チェックです。申告内容、レベル、フラグと、指定されたアドレスへの支払い履歴を確認します。申告内容が古い場合、チェーンが途切れている場合、未解決のフラグがある場合は拒否し、承認なしに支払うことはありません
explain_agent（agent）	1 つのエージェントについて、レベルとその理由、支払先と支払内容、フラグ、データからは分からないことを平易な言葉で説明します
where_agents_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
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日以降、シャドーモードで運用）

エージェントが支払う前のチェック（gate_check、payee_facts）、支払い後の監視（agent_pattern）、測定内容を示す3時間有効の署名付きステートメント（agent_pass）、鍵が盗まれた場合に移動される資産（blast_radius）、および設置されたデコイ（canary_register、canary_status）を提供します。すべてチェーンと台帳から測定し、エージェントの申告は参照しません。回答にはすべて測定時刻と定義 ID が含まれます。いずれも判定ではなく、シャドーモードではブロックもアラートも行いません。仕組みと最新の数値については、agenticfinancegraph.com/security をご覧ください。

x402 クライアント向け Gate フック

bin/x402-gate-hook.mjs は、@x402/core 2.x クライアント向けの onBeforePaymentCreation フックです。スキームが署名する前に、エージェント、支払先、署名対象の金額（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）とエージェントの証明を取得し、リーフと head.agent_root までのパスを再構築して、合計金額がカウントされた総額全体と一致することを確認し、ヘッドの Ed25519 署名を検証します。各チェックにつき 1 行を表示し、失敗がある場合は終了コード 1 を返します。回答に表示された鍵を信頼しないようにするには、別経路で渡された 32 バイトの 16 進数キーを AFG_SUMLOG_PUBKEY に設定してください。

afg chaincheck <agent-id> は、当方が運用していない公開 Base RPC（デフォルトは https://mainnet.base.org。独自のものを使用するには AFG_BASE_RPC を設定）を通じて、エージェントの公開記録をブロックチェーンそのものと照合します。ミントトランザクション（指定されたアカウントに、指定された時刻にミントされたこと）を読み取り、オープンなバインディングごとにレジストリを呼び出し（ownerOf、getAgentWallet。ミントアカウントのバインディングは、登録のミント先アカウントと一致する必要があります）、記録の資金経路にあるすべての支払いのレシートを読み取ります。つまり、コントラクトアドレスで特定される USDC、USDT、EURC、DAI の送金が成功しており、エージェントに紐付けられたウォレットのいずれかから、登録後に、指定された金額が指定された受取人へ送金されていることを確認します。各主張につき 1 行を表示します。RPC から返されなかった主張は未読として表示され、合格とは見なされません。ブロックチェーンから読み取った主張が成立しない場合は終了コード 1 を返します。

afg editioncheck <period> は、State of Agent Money のエディション（2026-09、または 2026-Q4 のような四半期）を読者が検証するためのコマンドです。エディションファイルを取得し、その SHA-256 がステートメントログにコミットされたハッシュと一致することを確認します。また、期間中にミントされた登録数と、期間末時点の合計を、期間の最初と最後のブロックにおける ERC-8004 Identity Registry から再計算します（エージェント ID は連番のため、各ブロックで ownerOf に応答する最大 ID が件数になります。当方が運用していない公開 Base RPC を使用します。独自のものを使用するには AFG_BASE_RPC を設定してください）。さらに、エディションが参照するすべての定義 ID が解決されることを確認します。カウントされた支払いは、台帳のバインディング一式が必要なため、ここでは再計算しません。1 つのエージェントについては afg chaincheck <agent> が実行します。チェックに失敗がある場合は終了コード 1 を返します。

afg logwatch [state-file] は、ステートメントログ（署名済みの 3 時間ごとのステートメントルートすべてを記録する RFC 6962 ツリー）の外部監視ツールです。1 回実行した後、継続して実行してください。1 日 1 回の cron で十分です。

• 毎回の実行時： 現在の署名済みツリーヘッドの Ed25519 署名を検証します。
• 2 回目以降の実行時： 前回保持したヘッドからの一貫性証明を取得し、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 ですべて確認してください。数値に誤りが判明した場合は、変更履歴で日付とともに公開して訂正します。

セキュリティ

すべてのプッシュとプルリクエストは、特定のコミットに固定され、読み取り専用の権限で実行される HOL AI Plugin Scanner によってスキャンされます。Dependabot はワークフローのアクションを監視します。このパッケージには依存関係がなく、接続先のサーバーは読み取り専用です。ここで資金が移動することはありません。問題を見つけた場合は、SECURITY.mdをご覧ください。変更内容と時期については、CHANGELOG.mdをご覧ください。

協業について

• 開発者の皆さんへ： 必要としている支援をご覧ください。MCP クライアント、フレームワークアダプター、Python クライアント、レシピなどを募集しています。創設チームへの参加を希望する方も歓迎します。
• プラットフォーム、機関、投資家の皆さんへ： agenticfinancegraph.com/contact
• エージェントの皆さんへ： {kind, message, reply_to} を指定して POST https://agenticfinancegraph.com/api/contact を送信してください。

X @AgenticGraph · Telegram · [email protected] · Base 上の ERC-8004 エージェント #95875

エージェントスキル：支払いの前にエージェントを確認する

Agent Skills に対応済みのアシスタントやエージェントフレームワーク（Claude Code、Cursor、Codex、OpenClaw など）向けのスキルファイルです：skills/afg-check-agent/SKILL.md。資金が移動する前に、この MCP サーバーをどのように使うかをアシスタントに指示します。エージェントを見つけ、その記録と署名付きの3時間ステートメントを読み取り、エージェントと支払い予定の取引相手に関する検出情報を確認し、判定ではなく、定義と測定時刻を添えて根拠を報告します。

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

ライセンス

このリポジトリのコードには Apache-2.0 ライセンスが適用されます。エンドポイントが提供するデータは Agentic Finance Graph のものです。引用する際は、定義 ID と測定時刻を添えてください。