MCP server de ProofCheck
Commit 28 oct 2026Verifica ofertas y recibos firmados con x402 mediante la comprobación de firmas criptográficas y la autorización del firmante contra registros de dominio y blockchain.
También conocido como something-agent/proofcheck
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.0
- Último commit
- 28 oct 2026
- Licencia
- MIT
¿Qué es ProofCheck MCP?
ProofCheck es un MCP server. Verifica ofertas y recibos firmados con x402 mediante la comprobación de firmas criptográficas y la autorización del firmante contra registros de dominio y blockchain.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ProofCheck
ProofCheck permite a los desarrolladores que trabajan con la extensión offer-receipt verificar la autenticidad de ofertas y recibos firmados con x402. Va más allá de una simple comprobación de firmas al validar si un firmante está realmente autorizado para representar un dominio o servicio específico. Esto se logra cruzando claves criptográficas con registros de dominio, registros DNS TXT y datos de blockchain.
Este MCP server remoto se ejecuta en Cloudflare Workers y no requiere API keys para su uso. Proporciona herramientas especializadas como verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint y lookup_erc8004_agent. Los usuarios pueden conectarse a través del endpoint MCP proporcionado para realizar verificaciones criptográficas de alta velocidad. El sistema admite varios formatos de firma, incluidos EIP-712 y JWS, y puede realizar búsquedas de agentes ERC-8004 en múltiples redes como Ethereum, Base y Polygon.
A diferencia de los SDK estándar que solo confirman que una firma es matemáticamente válida, esta herramienta evalúa la solidez de la evidencia. Distingue entre una autorización sólida, como claves encontradas en un documento did:web o controladores DNS, y afirmaciones más débiles. Esto ayuda a los desarrolladores a identificar si una clave está realmente vinculada a la URL del recurso o si es simplemente un firmante no comprobado.
Qué puedes hacer con él
- 1Validar la autenticidad de ofertas x402Comprueba si una oferta firmada es criptográficamente válida y si el firmante está autorizado para la URL del recurso específica.
- 2Verificar recibos de pagoConfirma que un recibo coincida con el recurso, el pagador y los detalles de la transacción esperados.
- 3Realizar preflights de endpointsPrueba un endpoint x402 para ver si requiere un pago antes de intentar una transacción completa.
- 4Buscar la identidad de un agente en blockchainRecupera detalles del agente ERC-8004 desde las redes blockchain compatibles.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar ProofCheck MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar ProofCheck MCP en Claude Code
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpInstalar ProofCheck MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}Instalar ProofCheck MCP en VS Code
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}Instalar ProofCheck MCP en VS Code CLI
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'Instalar ProofCheck MCP en Codex
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpInstalar ProofCheck MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
Instalar ProofCheck MCP en Gemini CLI
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpInstalar ProofCheck MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblesomething-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-28github.com/something-agent/proofcheck ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 80 msAprobado
README
Ver en 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.
Preguntas sobre ProofCheck MCP
¿Cómo agrego ProofCheck MCP a Claude Code?
Ejecuta claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego ProofCheck MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Requiere ProofCheck una API key?
No, el servicio es gratuito y no requiere una API key.
¿Qué tipo de evidencia proporciona ProofCheck para la autorización?
Evalúa la solidez de la evidencia utilizando métodos como did_web, dns_controllers y erc8004 para determinar si un firmante está autorizado para un servicio.
¿Puede ProofCheck confirmar que un pago se liquidó on-chain?
No, no confirma la liquidación on-chain; solo verifica la validez del artefacto firmado.
¿Cuáles son los posibles veredictos de verificación?
Los veredictos incluyen valid_authorized, valid_signer_unproven, rejected e invalid_signature.