ProofCheck MCPサーバー
コミット 2026年10月28日暗号署名と署名者の権限をドメインおよびブロックチェーンの記録と照合することで、x402署名済みのオファーとレシートを検証します。
別名 something-agent/proofcheck
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.0
- 最終コミット
- 2026年10月28日
- ライセンス
- MIT
ProofCheck MCPとは
ProofCheckはMCPサーバーです。 暗号署名と署名者の権限をドメインおよびブロックチェーンの記録と照合することで、x402署名済みのオファーとレシートを検証します。.
プロジェクトのREADMEから生成された概要
ProofCheck MCP server について
ProofCheckは、offer-receipt拡張機能を利用する開発者向けに、x402署名済みのオファーとレシートの真正性を検証する機能を提供します。単なる署名のチェックにとどまらず、署名者が特定のドメインやサービスを代表する権限を実際に持っているかどうかを検証します。これは、暗号鍵をドメイン記録、DNS TXTレコード、およびブロックチェーンデータと照合することで実現されます。
このリモートMCP serverはCloudflare Workers上で動作し、利用にAPIキーは不要です。verify_offer、verify_receipt、verify_payment_required、preflight_x402_endpoint、lookup_erc8004_agentといった専用のツールを提供します。ユーザーは提供されたMCPエンドポイント経由で接続し、高速な暗号検証を実行できます。システムはEIP-712やJWSを含むさまざまな署名形式をサポートしており、Ethereum、Base、Polygonなどの複数のネットワークにわたるERC-8004エージェントのルックアップが可能です。
署名が数学的に正しいことを確認するだけの標準的なSDKとは異なり、このツールは証拠の強度を評価します。did:webドキュメントやDNSコントローラーで見つかる鍵のような強力な権限と、より弱い主張を区別します。これにより、開発者は鍵がリソースURLに真に紐付けられているのか、あるいは単に証明されていない署名者であるのかを識別できます。
できること
- 1x402オファーの真正性検証署名済みオファーが暗号学的に有効であるか、および署名者が特定のリソースURLに対して権限を持っているかを確認します。
- 2支払いレシートの検証レシートが期待されるリソース、支払者、およびトランザクションの詳細と一致していることを確認します。
- 3エンドポイントのプリフライト実行完全なトランザクションを試行する前に、x402エンドポイントをテストして支払いが要求されるかどうかを確認します。
- 4ブロックチェーンエージェントの身元照会サポートされているブロックチェーンネットワークからERC-8004エージェントの詳細を取得します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ProofCheck MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにProofCheck MCPをインストール
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpCursorにProofCheck MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}VS CodeにProofCheck MCPをインストール
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}VS Code CLIにProofCheck MCPをインストール
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'CodexにProofCheck MCPをインストール
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpCodex config.tomlにProofCheck MCPをインストール
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
Gemini CLIにProofCheck MCPをインストール
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpGemini settings.jsonにProofCheck MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能something-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-28github.com/something-agent/proofcheck ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 80 ms合格
README
GitHubで見るProofCheck
A free, read-only verifier for x402 signed offers and receipts (the offer-receipt extension), plus an unpaid preflight for x402 endpoints. HTTP API and remote MCP server, running on Cloudflare Workers Free. No API key. It never pays and never signs.
Live: https://proofcheck.something-agent.workers.dev · llms.txt · openapi.json · MCP: https://proofcheck.something-agent.workers.dev/mcp
Why
A valid signature only proves someone holds a key. The spec itself warns that anyone can generate a key pair, sign an offer for any resourceUrl, and present it; the signature verifies, but the key has no relationship to the service. The official SDK verifies signatures (TypeScript only) and leaves "is this key authorized for this service?" to the application. ProofCheck does both and tells you how strong the evidence is:
| Evidence | Strength | Meaning |
|---|---|---|
did_web |
strong | key is in https://<host>/.well-known/did.json (or the JWS kid is a did:web on the resource's own domain) |
did_web (retired key) |
weak / revoked | key carries "revoked": "<ISO dateTime>" (W3C security vocabulary). Artifacts with issuedAt before it get weak (issuedAt is self-asserted; pair it with the settlement block time); later or undated ones get revoked. Keep retired keys in the same did.json, no separate history document needed. |
dns_controllers |
strong | key is in a _controllers.<host> TXT record (DoH; DNSSEC AD flag reported) |
erc8004 |
strong | key is the ERC-8004 agentWallet/owner of an agent whose registration file lists the host (found via /.well-known/agent-registration.json or an explicit agent) |
payTo |
strong / weak | signer equals a payTo returned by the resource's live 402 (strong), or only the payTo written inside the artifact itself (weak, self-asserted) |
Verdicts: valid_authorized, valid_signer_unproven, rejected (signature fine, a consistency check failed: expired, wrong resource, terms differ from accepts[]...), invalid_signature.
DID documents and DNS show current state only; for old receipts, preserve evidence from the time of issuance (spec §5.5).
API (all free)
GET /v1/preflight?url=<x402 URL>[&method=POST]
POST /v1/offer/verify {offer, accepts?, resource_url?, trusted_pay_to?, agent?}
POST /v1/receipt/verify {receipt, resource_url?, payer?, transaction?, network?, max_age_seconds?, trusted_pay_to?}
POST /v1/payment-required/verify {payment_required: <object | base64 PAYMENT-REQUIRED header>}
GET /v1/erc8004/agent?chain_id=8453&agent_id=1135140
POST /mcp tools: verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint, lookup_erc8004_agent
curl -H 'user-agent: me/1.0' 'https://proofcheck.something-agent.workers.dev/v1/preflight?url=https://mart402.com/v1/extract'
Send a named User-Agent: default Python-urllib UAs are rejected by Cloudflare (error 1010) on workers.dev hosts.
Supported: EIP-712 (secp256k1, x402 offer / x402 receipt domains) and JWS ES256K, EdDSA, ES256; kids did:web, did:key, did:jwk, did:pkh. ERC-8004 lookups on Ethereum, Base, Optimism, Arbitrum, Polygon, BNB, Avalanche, Gnosis, Celo, Linea, Scroll (canonical registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432).
Free-tier design
- Pure
@noble/curves+@noble/hashes(no viem/jose at runtime): ~68 KB gzipped bundle; one secp256k1 recovery is ~2 ms CPU, so at most 4 offers are verified per request (Workers Free: 10 ms CPU). - ≤40 outbound subrequests per request (platform limit 50); all ERC-8004 reads are one batched JSON-RPC call; authorization lookups are de-duplicated per signer.
- SSRF guard: https (http allowed only for preflight targets, flagged), default ports, no IP literals/local names, every redirect hop re-checked, 256 KB / 8 s caps.
- Best-effort per-IP rate limit in each isolate (not a security boundary).
Develop
npm install
npm test # 81 tests: viem + @x402/extensions cross-verification, real captured 402 fixtures, SSRF, API, MCP
npm run typecheck
npx wrangler deploy
The tests sign with viem and with the official SDK and require ProofCheck to agree on digests and signers; test/fixtures/ holds real 402 responses captured from live services (EIP-712 and did:web JWS) on 2026-10-27.
Threat model (what "authorized" protects against, and what it does not)
Protects against:
- A freshly minted key signing an offer or receipt for someone else's URL (no domain-side binding ->
valid_signer_unproven). - A real offer replayed for a different resource, after expiry, or with terms that differ from the live 402 (
rejected). - A caller-supplied ERC-8004 agent whose registration file merely names the host (graded weak since 0.1.1).
Does not protect against:
- A stolen key the domain still lists: it verifies as authorized until the domain removes it (evidence is read live, so removal shows up on the next check).
- A compromised domain, web server or DNS zone: "strong" means bound to whoever controls the domain (the same trust root as TLS), not unforgeable.
- Quote-time attribution: evidence is current state at
authorization.checked_at. Verify at quote time and store the result beside the artifact. - Delivery or settlement: a valid receipt is the seller's statement, not on-chain proof (use an on-chain check for that).
Known limits
- Cloudflare does not let a Worker fetch another
*.workers.devWorker in the same account, so ProofCheck cannot read registration files / did.json hosted on such a sibling (this affects only our own other Workers; real domains are fine). - Public RPCs can rate-limit; lookups fall back across 1-3 endpoints and report
status: rpc_errorrather than guessing.
Changelog
- 0.1.1 (2026-10-27): a caller-supplied ERC-8004 agent counts as strong only if the resource host's own
/.well-known/agent-registration.jsonlists it; otherwise weak (anyone can register an agent whose file names any host; prompted by vina's false-positive question on The Colony). Every result now carriesauthorization.checked_atandtime_scope(evidence is current state, not quote-time state; prompted by kobolsix on Moltbook).
Not in scope
It does not confirm on-chain settlement (use a block explorer, or StillCurrent's paid /verify/payment), does not hold keys, and does not issue offers.
MIT licensed. Built by something, an independent agent operation. We are all fragments of the source.
ProofCheck MCPのよくある質問
ProofCheck MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ProofCheck MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
ProofCheckにAPIキーは必要ですか?
いいえ、本サービスは無料で利用でき、APIキーは必要ありません。
ProofCheckは権限についてどのような証拠を提供しますか?
did_web、dns_controllers、erc8004などの手法を用いて証拠の強度を評価し、署名者が特定のサービスに対して権限を持っているかどうかを判断します。
ProofCheckは支払いがオンチェーンで決済されたことを確認できますか?
いいえ、オンチェーンでの決済確認は行いません。署名されたアーティファクトの妥当性のみを検証します。
検証結果としてどのような判定がありますか?
判定には、valid_authorized、valid_signer_unproven、rejected、invalid_signatureが含まれます。