ProofCheck MCP sunucusu
Commit 28 Eki 2026Kriptografik imzaları ve imzalayıcı yetkilerini alan adı ve blockchain kayıtlarıyla karşılaştırarak x402 imzalı teklifleri ve makbuzları doğrular.
Ayrıca bilinen adı something-agent/proofcheck
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.0
- Son commit
- 28 Eki 2026
- Lisans
- MIT
ProofCheck MCP nedir?
ProofCheck bir MCP sunucusudur. Kriptografik imzaları ve imzalayıcı yetkilerini alan adı ve blockchain kayıtlarıyla karşılaştırarak x402 imzalı teklifleri ve makbuzları doğrular.
Özet, projenin README dosyasından oluşturuldu
ProofCheck MCP sunucusu hakkında
ProofCheck, teklif-makbuz (offer-receipt) uzantısıyla çalışan geliştiricilerin x402 imzalı tekliflerin ve makbuzların orijinalliğini doğrulamasına olanak tanır. Basit imza kontrollerinin ötesine geçerek, bir imzalayıcının belirli bir alan adını veya servisi temsil etmeye gerçekten yetkili olup olmadığını denetler. Bu işlem; kriptografik anahtarların alan adı kayıtları, DNS TXT kayıtları ve blockchain verileriyle çapraz referanslanmasıyla gerçekleştirilir.
Bu uzak MCP server, Cloudflare Workers üzerinde çalışır ve kullanımı için herhangi bir API anahtarı gerektirmez. verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint ve lookup_erc8004_agent gibi özelleşmiş araçlar sunar. Kullanıcılar, yüksek hızlı kriptografik doğrulamalar gerçekleştirmek için sağlanan MCP endpoint üzerinden bağlantı kurabilirler. Sistem, EIP-712 ve JWS dahil olmak üzere çeşitli imza formatlarını destekler ve Ethereum, Base ve Polygon gibi birden fazla ağda ERC-8004 agent sorgulamaları yapabilir.
Bir imzanın matematiksel olarak geçerli olduğunu onaylayan standart SDK'ların aksine, bu araç kanıtın gücünü değerlendirir. did:web dokümanında veya DNS denetleyicilerinde bulunan anahtarlar gibi güçlü yetkilendirmeler ile daha zayıf iddialar arasında ayrım yapar. Bu sayede geliştiriciler, bir anahtarın kaynak URL'sine gerçekten bağlı olup olmadığını veya sadece kanıtlanmamış bir imzalayıcı olup olmadığını tespit edebilirler.
Neler yapabilirsiniz
- 1x402 teklif orijinalliğini doğrulamaİmzalı bir teklifin kriptografik olarak geçerli olup olmadığını ve imzalayıcının belirli kaynak URL için yetkili olup olmadığını kontrol edin.
- 2Ödeme makbuzlarını doğrulamaBir makbuzun beklenen kaynak, ödeyen ve işlem detaylarıyla eşleştiğini onaylayın.
- 3Endpoint ön kontrolleri gerçekleştirmeTam bir işlem denemeden önce bir x402 endpoint'inin ödeme gerektirip gerektirmediğini test edin.
- 4Blockchain agent kimliğini sorgulamaDesteklenen blockchain ağlarından ERC-8004 agent detaylarını getirin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ProofCheck MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleProofCheck MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpProofCheck MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}ProofCheck MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}ProofCheck MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'ProofCheck MCP'yi Codex içine yükleyin
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpProofCheck MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
ProofCheck MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpProofCheck MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirsomething-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-28github.com/something-agent/proofcheck ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 80 msGeçti
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 soruları
ProofCheck MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
ProofCheck MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
ProofCheck bir API anahtarı gerektiriyor mu?
Hayır, servis ücretsizdir ve bir API anahtarı gerektirmez.
ProofCheck yetkilendirme için ne tür kanıtlar sunar?
Bir imzalayıcının bir servis için yetkili olup olmadığını belirlemek amacıyla did_web, dns_controllers ve erc8004 gibi yöntemleri kullanarak kanıt gücünü değerlendirir.
ProofCheck bir ödemenin on-chain olarak tamamlandığını onaylayabilir mi?
Hayır, on-chain mutabakatı onaylamaz; yalnızca imzalı nesnenin geçerliliğini doğrular.
Olası doğrulama sonuçları nelerdir?
Sonuçlar arasında valid_authorized, valid_signer_unproven, rejected ve invalid_signature bulunur.