MCP server ProofCheck
Commit 28 de out. de 2026Verifica ofertas e recibos assinados via x402, checando assinaturas criptográficas e a autorização do signatário contra registros de domínio e blockchain.
Também conhecido como something-agent/proofcheck
- Stars
- 0
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 0.1.0
- Último commit
- 28 de out. de 2026
- Licença
- MIT
O que é o MCP ProofCheck?
Verifica ofertas e recibos assinados via x402, checando assinaturas criptográficas e a autorização do signatário contra registros de domínio e blockchain.
Resumo gerado a partir do README do projeto
Sobre o MCP server de ProofCheck
Verificar a autenticidade de ofertas e recibos assinados via x402 é o que o ProofCheck permite para desenvolvedores que trabalham com a extensão offer-receipt. Ele vai além de simples verificações de assinatura, validando se um signatário está realmente autorizado a representar um domínio ou serviço específico. Isso é feito cruzando chaves criptográficas com registros de domínio, registros DNS TXT e dados de blockchain.
Este MCP server remoto roda em Cloudflare Workers e não exige chaves de API para uso. Ele fornece ferramentas especializadas como verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint e lookup_erc8004_agent. Os usuários podem se conectar via endpoint MCP fornecido para realizar verificações criptográficas de alta velocidade. O sistema suporta vários formatos de assinatura, incluindo EIP-712 e JWS, e pode realizar buscas de agentes ERC-8004 em múltiplas redes como Ethereum, Base e Polygon.
Diferente de SDKs padrão que apenas confirmam se uma assinatura é matematicamente válida, esta ferramenta avalia a força da evidência. Ela distingue entre autorização forte, como chaves encontradas em um documento did:web ou controladores DNS, e afirmações mais fracas. Isso ajuda desenvolvedores a identificar se uma chave está verdadeiramente vinculada à URL do recurso ou se é apenas um signatário não comprovado.
O que você pode fazer com ele
- 1Validar autenticidade de ofertas x402Verifique se uma oferta assinada é criptograficamente válida e se o signatário está autorizado para a URL do recurso específico.
- 2Verificar recibos de pagamentoConfirme se um recibo corresponde ao recurso, pagador e detalhes da transação esperados.
- 3Realizar preflights de endpointTeste um endpoint x402 para ver se ele exige pagamento antes de tentar uma transação completa.
- 4Buscar identidade de agente na blockchainRecupere detalhes de agentes ERC-8004 em redes blockchain suportadas.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP ProofCheck
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP ProofCheck no Claude Code
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpInstalar o MCP ProofCheck no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}Instalar o MCP ProofCheck no VS Code
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}Instalar o MCP ProofCheck no VS Code CLI
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'Instalar o MCP ProofCheck no Codex
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpInstalar o MCP ProofCheck no Codex config.toml
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
Instalar o MCP ProofCheck no Gemini CLI
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpInstalar o MCP ProofCheck no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}Verificações automatizadas
Executado em 15 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelsomething-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-28github.com/something-agent/proofcheck ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPinitialize answered with protocol 2025-06-18 in 80 msPassou
README
Ver no 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.
Perguntas sobre o MCP ProofCheck
Como adiciono o MCP ProofCheck ao Claude Code?
Execute claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP ProofCheck ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
O ProofCheck requer uma chave de API?
Não, o serviço é gratuito e não requer uma chave de API.
Que tipo de evidência o ProofCheck fornece para autorização?
Ele avalia a força da evidência usando métodos como did_web, dns_controllers e erc8004 para determinar se um signatário está autorizado para um serviço.
O ProofCheck pode confirmar se um pagamento foi liquidado on-chain?
Não, ele não confirma a liquidação on-chain; ele apenas verifica a validade do artefato assinado.
Quais são os possíveis vereditos de verificação?
Os vereditos incluem valid_authorized, valid_signer_unproven, rejected e invalid_signature.