⚓️ Truth Anchor Agent

Truth Anchor Agentは、**引用の証明（citation attestation）**を行うためのMCP（Model Context Protocol）サーバーです。エージェントがソースを引用する前に、URLが解決されることを確認し、最終的な宛先を記録し、軽量なページメタデータを取得し、取得したコンテンツのハッシュを返すことができます。

課題: AIエージェントは、使用時点でソースがどのような状態であったかを確認せずに、リンク切れ、リダイレクト、または変更されたURLを引用することがよくあります。 解決策: エージェントが引用に依存する前に、ソースの可用性と軽量な証明メタデータを記録する有料の検証ステップを提供します。

保証されること

• 検証時にURLが取得されたこと。

• サービスが最終的なURL、HTTPステータス、リダイレクトの挙動、および基本的なHTMLメタデータを報告すること。

• レスポンスに content_sha256 ハッシュが含まれ、後続のシステムが観測された内容を固定（アンカー）できること。

• オプションのクレーム照合が単純な部分文字列チェックであること。

Related MCP server: Predicate

保証されないこと

• セマンティックなファクトチェックエンジンではありません。

• ページが信頼できることを証明するものではなく、サービスが取得した時点で観測された内容を示すのみです。

• 複雑な主張に対する検索、RAG、または人間のレビューに代わるものではありません。

🛠 Model Context Protocol (MCP) 統合

このサーバーは、MCP準拠のLLM（Claude Desktop、ChatGPT、IDEなど）が自律的に使用できる verify_url ツールを公開しています。

Claude Desktopへの登録

claude_desktop_config.json に以下を追加してください：

{
  "mcpServers": {
    "truth-anchor": {
      "command": "npx",
      "args": ["-y", "truth-anchor-agent"],
      "env": {
        "MY_WALLET_ADDRESS": "0x367B9193D4F9cb4877Ca58E6F3ce944d761d8009"
      }
    }
  }
}

インターフェース

MCPツール

MCPツールは2ステップのフローを使用します：

1. URLを指定して verify_url を呼び出す。

2. 支払い証明が提供されていない場合は、支払い手順を受け取る。

3. 支払い送信後、 tx_hash を指定して再試行する。

HTTP API

HTTP APIは、APIキーとx402形式の署名付き支払いを使用します：

1. POST /auth/provision を呼び出して無料のAPIキーを取得する。

2. 最初の50リクエストは無料で利用可能。

3. それ以降は、 POST /verify に X-Payment を付与する。

💳 支払いフロー

HTTP APIは、無料枠を使い切った後の有料リクエストに対して 402 Payment Required フローを実装しています。

1. リクエスト: エージェントがURLを指定して /verify を呼び出す。

2. チャレンジ: サーバーが支払い手順とともに 402 Payment Required を返す。

3. 支払い: エージェントがBase USDC支払い承認に署名する。

4. 検証: エージェントが X-Payment ヘッダーを付けて再試行する。

5. 証明: サーバーが支払いを検証し、ソースチェックの結果を返す。

⚡️ APIリファレンス

POST /verify

ソースが解決されることを検証し、証明メタデータを返します。以下が必要です：

• Authorization: Bearer <api_key>

• 無料枠を使い切った後の X-Payment

ヘッダー:

リクエストボディ:

{
  "url": "https://base.org",
  "claim": "Base is an Ethereum L2"
}

成功レスポンス (200 OK):

{
  "url": "https://base.org",
  "final_url": "https://base.org/",
  "is_live": true,
  "status_code": 200,
  "redirected": false,
  "ssl_valid": true,
  "checked_at": "2026-04-02T12:00:00Z",
  "content_type": "text/html",
  "content_length_bytes": 31245,
  "title": "Base",
  "description": "Base is a secure, low-cost, builder-friendly Ethereum L2.",
  "content_sha256": "9d72c4...",
  "claim": "Base is an Ethereum L2",
  "claim_found": true,
  "claim_match_method": "substring",
  "paid": false,
  "free_requests_remaining": 49
}

🏗 技術スタック

• FastAPI — 高性能なPython APIフレームワーク。

• Web3.py — リアルタイムのオンチェーン検証（Base RPC）。

• SQLite — リプレイ攻撃の防止およびトランザクションのインデックス作成。

• Fly.io — グローバルエッジデプロイメント。

• Base — 高速で低コストなUSDC支払いのためのL2 Ethereum。

ポジショニングに関するメモ

• 主要な切り口: エージェントのための引用証明

• 現時点では対象外: 広範な 真実のレイヤー、一般的なファクトチェック、マルチツール拡張

• 製品のギャップと検証に関するメモは docs/product-positioning.md、 docs/user-validation.md、および docs/user-validation-proxy.md に記載されています。

🛠 ローカル開発

# 1. Clone and Install
git clone https://github.com/cristiano-c1/truth-anchor-agent
cd truth-anchor-agent
pip install -r requirements.txt

# 2. Configure
echo "MY_WALLET_ADDRESS=0x367B9193D4F9cb4877Ca58E6F3ce944d761d8009" > .env

# 3. Run
uvicorn main:app --reload

📜 ライセンス

MITライセンスの下で配布されています。詳細については LICENSE を参照してください。