ProofCheck MCP server
Commit 28. Okt. 2026Verifiziert x402-signierte Angebote und Quittungen, indem kryptografische Signaturen und die Autorisierung des Signers gegen Domain- und Blockchain-Einträge geprüft werden.
Auch bekannt als something-agent/proofcheck
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.0
- Letzter Commit
- 28. Okt. 2026
- Lizenz
- MIT
Was ist ProofCheck MCP?
ProofCheck ist ein MCP server. Verifiziert x402-signierte Angebote und Quittungen, indem kryptografische Signaturen und die Autorisierung des Signers gegen Domain- und Blockchain-Einträge geprüft werden.
Zusammenfassung generiert aus dem README des Projekts
Über ProofCheck MCP server
ProofCheck ermöglicht es Entwicklern, die mit der Offer-Receipt-Extension arbeiten, die Authentizität von x402-signierten Angeboten und Quittungen zu verifizieren. Es geht über einfache Signaturprüfungen hinaus, indem es validiert, ob ein Signer tatsächlich autorisiert ist, eine bestimmte Domain oder einen bestimmten Dienst zu repräsentieren. Dies geschieht durch den Abgleich kryptografischer Schlüssel mit Domain-Einträgen, DNS TXT-Records und Blockchain-Daten.
Dieser Remote MCP server läuft auf Cloudflare Workers und benötigt keine API-Keys für die Nutzung. Er stellt spezialisierte Tools wie verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint und lookup_erc8004_agent bereit. Nutzer können sich über den bereitgestellten MCP endpoint verbinden, um hochgeschwindigkeits-kryptografische Verifizierungen durchzuführen. Das System unterstützt verschiedene Signaturformate, einschließlich EIP-712 und JWS, und kann ERC-8004 Agent-Lookups über mehrere Netzwerke wie Ethereum, Base und Polygon hinweg durchführen.
Im Gegensatz zu Standard-SDKs, die nur bestätigen, dass eine Signatur mathematisch korrekt ist, bewertet dieses Tool die Stärke der Nachweise. Es unterscheidet zwischen starker Autorisierung, wie etwa Schlüsseln, die in einem did:web-Dokument oder bei DNS-Controllern gefunden werden, und schwächeren Behauptungen. Dies hilft Entwicklern zu identifizieren, ob ein Schlüssel tatsächlich an die Resource-URL gebunden ist oder ob es sich lediglich um einen unbewiesenen Signer handelt.
Was du damit machen kannst
- 1Validierung der x402-AngebotsauthentizitätPrüfen, ob ein signiertes Angebot kryptografisch gültig ist und ob der Signer für die spezifische Resource-URL autorisiert ist.
- 2Verifizierung von ZahlungsbelegenBestätigen, dass eine Quittung mit der erwarteten Resource, dem Zahler und den Transaktionsdetails übereinstimmt.
- 3Durchführung von Endpoint-PreflightsEinen x402-Endpoint testen, um zu sehen, ob eine Zahlung erforderlich ist, bevor eine vollständige Transaktion versucht wird.
- 4Suche nach Blockchain-Agent-IdentitätenAbrufen von ERC-8004 Agent-Details aus unterstützten Blockchain-Netzwerken.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du ProofCheck MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenProofCheck MCP in Claude Code installieren
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpProofCheck MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}ProofCheck MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}ProofCheck MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'ProofCheck MCP in Codex installieren
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpProofCheck MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
ProofCheck MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpProofCheck MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarsomething-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-28github.com/something-agent/proofcheck ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 80 msBestanden
README
Auf GitHub ansehenProofCheck
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 Fragen
Wie füge ich ProofCheck MCP zu Claude Code hinzu?
Führe claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich ProofCheck MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Benötigt ProofCheck einen API-Key?
Nein, der Service ist kostenlos und benötigt keinen API-Key.
Welche Art von Nachweisen liefert ProofCheck für die Autorisierung?
Es bewertet die Stärke der Nachweise mit Methoden wie did_web, dns_controllers und erc8004, um festzustellen, ob ein Signer für einen Dienst autorisiert ist.
Kann ProofCheck bestätigen, dass eine Zahlung on-chain abgewickelt wurde?
Nein, es bestätigt keine On-Chain-Abwicklung; es verifiziert lediglich die Gültigkeit des signierten Artefakts.
Was sind die möglichen Verifikations-Ergebnisse?
Die Ergebnisse umfassen valid_authorized, valid_signer_unproven, rejected und invalid_signature.