Serveur MCP ProofCheck
Commit 28 oct. 2026Vérifie les offres et reçus signés x402 en contrôlant les signatures cryptographiques et l'autorisation du signataire par rapport aux enregistrements de domaine et de la blockchain.
Aussi connu sous something-agent/proofcheck
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.0
- Dernier commit
- 28 oct. 2026
- Licence
- MIT
Qu'est-ce que ProofCheck MCP ?
ProofCheck est un serveur MCP. Vérifie les offres et reçus signés x402 en contrôlant les signatures cryptographiques et l'autorisation du signataire par rapport aux enregistrements de domaine et de la blockchain.
Résumé généré à partir du README du projet
À propos du MCP server ProofCheck
ProofCheck permet aux développeurs travaillant avec l'extension offer-receipt de vérifier l'authenticité des offres et reçus signés x402. Il va au-delà de la simple vérification de signature en validant si un signataire est réellement autorisé à représenter un domaine ou un service spécifique. Cela est réalisé en recoupant les clés cryptographiques avec les enregistrements de domaine, les enregistrements DNS TXT et les données de la blockchain.
Ce MCP server distant s'exécute sur Cloudflare Workers et ne nécessite aucune clé API pour être utilisé. Il fournit des outils spécialisés tels que verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint et lookup_erc8004_agent. Les utilisateurs peuvent se connecter via l'endpoint MCP fourni pour effectuer des vérifications cryptographiques à haute vitesse. Le système prend en charge divers formats de signature, notamment EIP-712 et JWS, et peut effectuer des recherches d'agents ERC-8004 sur plusieurs réseaux comme Ethereum, Base et Polygon.
Contrairement aux SDK standards qui confirment seulement qu'une signature est mathématiquement valide, cet outil évalue la force de la preuve. Il distingue une autorisation forte, comme des clés trouvées dans un document did:web ou des contrôleurs DNS, des assertions plus faibles. Cela aide les développeurs à identifier si une clé est véritablement liée à l'URL de la ressource ou s'il s'agit simplement d'un signataire non prouvé.
Ce que vous pouvez faire avec
- 1Valider l'authenticité d'une offre x402Vérifier si une offre signée est cryptographiquement valide et si le signataire est autorisé pour l'URL de la ressource spécifique.
- 2Vérifier les reçus de paiementConfirmer qu'un reçu correspond à la ressource, au payeur et aux détails de transaction attendus.
- 3Effectuer des prévols d'endpointTester un endpoint x402 pour voir s'il nécessite un paiement avant de tenter une transaction complète.
- 4Rechercher l'identité d'un agent sur la blockchainRécupérer les détails de l'agent ERC-8004 à partir des réseaux blockchain pris en charge.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer ProofCheck MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller ProofCheck MCP dans Claude Code
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpInstaller ProofCheck MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}Installer ProofCheck MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}Installer ProofCheck MCP dans VS Code CLI
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'Installer ProofCheck MCP dans Codex
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpInstaller ProofCheck MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
Installer ProofCheck MCP dans Gemini CLI
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpInstaller ProofCheck MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblesomething-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-28github.com/something-agent/proofcheck ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 80 msRéussi
README
Voir sur GitHubProofCheck
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.
Questions sur ProofCheck MCP
Comment ajouter ProofCheck MCP à Claude Code ?
Exécutez claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter ProofCheck MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
ProofCheck nécessite-t-il une clé API ?
Non, le service est gratuit et ne nécessite pas de clé API.
Quel type de preuve ProofCheck fournit-il pour l'autorisation ?
Il évalue la force de la preuve en utilisant des méthodes telles que did_web, dns_controllers et erc8004 pour déterminer si un signataire est autorisé pour un service.
ProofCheck peut-il confirmer qu'un paiement a été réglé on-chain ?
Non, il ne confirme pas le règlement on-chain ; il vérifie uniquement la validité de l'artefact signé.
Quels sont les verdicts de vérification possibles ?
Les verdicts incluent valid_authorized, valid_signer_unproven, rejected et invalid_signature.