witnessd

witnessd-mcp

witnessd 用の MCP サーバー — 機械可読なウェブの中立的な第三者証人です。

エージェントが改ざんを検知できる証拠を作成できるようにします。witnessd が公開 URL または API エンドポイントを独立して取得し、レスポンスをハッシュ化してタイムスタンプを付与し、アーカイブしたうえで、署名付き証明書を発行します。スナップショットのハッシュは毎時マークルバッチにまとめられ、Base に記録されるため、証明書は運営者を信頼することなく、誰でもいつまでも検証できます。

取引相手と取引する前（「相手が公開している価格や条件を証拠として残す」）、第三者のデータに基づいて行動する前（「API が返した内容を証拠として残す」）、または後日、ある時点で URL に何が記載されていたかが紛争の鍵となる可能性がある場合にご利用ください。

クイックインストール

利用するもの	実行するコマンド
Claude Code（スキルと MCP サーバーを一度にインストール）	/plugin install witnessd --marketplace jschunter/witnessd-mcp
Agent Skills に対応するエージェント（Cursor、Codex、Copilot、Gemini CLI など）	npx skills add jschunter/witnessd-mcp
任意の MCP クライアント、MCP サーバーのみ	npx -y witnessd-mcp（設定は以下を参照）

スキル（plugin/skills/witnessd/SKILL.md）は、中立的な証人に2セントを支払う価値があるのは「いつ」なのかをエージェントに教えます。たとえば、見知らぬ販売者に支払う前、第三者のデータに基づいて行動する前、ページに何が記載されていたかの証明を求められたときです。また、支出ルールも設定します。承認なしで1つのタスクにつき有料の呼び出しは最大5回、各呼び出しについて1行で報告すること、ループ内で有料の再試行をしないことです。MCP サーバーはエージェントにツールを提供します。

古いバージョンの Claude Code では、/plugin marketplace add jschunter/witnessd-mcp を実行してから、/plugin install witnessd@witnessd を実行してください。

ツール

ツール	料金	機能
witness_url	$0.02	URL をその時点で独立して取得し、ハッシュ化、タイムスタンプ付与、アーカイブを行います。スナップショット ID と署名付き証明書を返します
get_certificate	無料	任意のスナップショット ID の証明書を取得します。マニフェスト、Ed25519 署名、マークル証明、Base アンカートランザクションを含みます
retrieve_snapshot	$0.05	アーカイブされたレスポンス本文と証明書を取得します。任意のスナップショット ID で、支払者を問わず利用できます（第三者が証拠を取得する方法です）

インストール

npx -y witnessd-mcp

Claude Desktop／Cursor の設定：

{
  "mcpServers": {
    "witnessd": {
      "command": "npx",
      "args": ["-y", "witnessd-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x…"
      }
    }
  }
}

支払い — 2つの方法

次の環境変数のいずれか1つを設定してください。

• EVM_PRIVATE_KEY — Base 上の USDC を保有するウォレットの秘密鍵です。サーバーは x402 を介して各呼び出しの支払いを自動で行います（購入者が署名するだけで、ガス代に ETH は不要です）。専用の少額ウォレットを使用し、メインのウォレットは絶対に使わないでください。
• WITNESSD_API_KEY — 前払いクレジットキーです（POST https://witnessd.vip/api/credits で x402 による支払いが可能な1ドルパックを購入できます）。

任意：別の witnessd インスタンスを指定するには WITNESSD_URL を設定します（デフォルトは https://witnessd.vip）。

信頼せずに検証する

証明書は単独で検証できます。leaf_hash = sha256(canonical-json(manifest)) は Ed25519 署名され、マークル証明によって毎時のバッチルートに結び付けられ、そのルートは Base に記録されます（calldata は 0x + wtns1 + root）。単体の検証ツール：witnessd.vip/verify.js。

プライバシーと対象範囲

証明書（ハッシュ、タイムスタンプ、証明）は公開されます。アーカイブされたコンテンツは有料リクエストを行ったユーザーにのみ提供され、再公開されることはありません。witnessd が証拠として残すのは、誰でも確認できる情報のみです。ログインは不要で、プライベートネットワークには対応せず、本文は10 MB以下です。機械可読なサービスドキュメント：llms.txt · openapi.json · /.well-known/x402。

MIT ライセンス。