Skip to main content
Glama
truth-anchor-agent

truth-anchor-agent

by cristiano-c1

⚓️ Truth Anchor Agent

License: MIT Built on Base MCP x402

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

ヘッダー:

ヘッダー

説明

Authorization

POST /auth/provision によって返されるAPIキー

X-Payment

無料枠以降の署名済みx402/EIP-3009支払いペイロード

リクエストボディ:

{
  "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 を参照してください。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that provides autonomous, multi-source web research capabilities for AI agents. It delivers comprehensive, validated information through deep research tools while maintaining security and compatibility with various LLM providers.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for AI agent trust verification, enabling agents to verify identities, check trust scores, and build reputation across multiple blockchain and web platforms.
      12
      15 npm
      1
      MIT