ProofCheck MCP server
2026년 10월 28일 커밋암호화 서명과 서명자 권한을 도메인 및 블록체인 기록과 대조하여 x402 서명 오퍼 및 영수증을 검증합니다.
다른 이름 something-agent/proofcheck
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.0
- 마지막 커밋
- 2026년 10월 28일
- 라이선스
- MIT
ProofCheck MCP란?
ProofCheck은(는) MCP server입니다. 암호화 서명과 서명자 권한을 도메인 및 블록체인 기록과 대조하여 x402 서명 오퍼 및 영수증을 검증합니다.
프로젝트 README에서 생성된 요약
ProofCheck MCP server 정보
ProofCheck는 offer-receipt 확장을 사용하는 개발자가 x402 서명 오퍼와 영수증의 진위 여부를 검증할 수 있도록 지원합니다. 단순히 서명을 확인하는 수준을 넘어, 서명자가 특정 도메인이나 서비스를 대표할 권한이 실제로 있는지 검증합니다. 이는 암호화 키를 도메인 기록, DNS TXT 레코드, 블록체인 데이터와 교차 참조하여 수행됩니다.
이 원격 MCP server는 Cloudflare Workers에서 실행되며 사용을 위한 API key가 필요하지 않습니다. verify_offer, verify_receipt, verify_payment_required, preflight_x402_endpoint, lookup_erc8004_agent와 같은 특화된 도구를 제공합니다. 사용자는 제공된 MCP endpoint를 통해 연결하여 고속 암호화 검증을 수행할 수 있습니다. 시스템은 EIP-712 및 JWS를 포함한 다양한 서명 형식을 지원하며, Ethereum, Base, Polygon과 같은 여러 네트워크에서 ERC-8004 agent 조회를 수행할 수 있습니다.
서명이 수학적으로 유효한지만 확인하는 표준 SDK와 달리, 이 도구는 증거의 강도를 평가합니다. did:web 문서나 DNS controllers에서 발견된 키와 같은 강력한 권한 부여와 더 약한 주장을 구분합니다. 이를 통해 개발자는 키가 리소스 URL에 실제로 결합되어 있는지, 아니면 단순히 증명되지 않은 서명자인지 식별할 수 있습니다.
활용 사례
- 1x402 오퍼 진위 확인서명된 오퍼가 암호학적으로 유효한지, 서명자가 특정 리소스 URL에 대한 권한이 있는지 확인합니다.
- 2결제 영수증 검증영수증이 예상되는 리소스, 지불자 및 트랜잭션 세부 정보와 일치하는지 확인합니다.
- 3엔드포인트 프리플라이트 수행전체 트랜잭션을 시도하기 전에 x402 엔드포인트가 결제를 요구하는지 테스트합니다.
- 4블록체인 agent 신원 조회지원되는 블록체인 네트워크에서 ERC-8004 agent 세부 정보를 가져옵니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ProofCheck MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 ProofCheck MCP 설치
$ claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpCursor에 ProofCheck MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}VS Code에 ProofCheck MCP 설치
.vscode/mcp.json
{
"servers": {
"proofcheck": {
"type": "http",
"url": "https://proofcheck.something-agent.workers.dev/mcp"
}
}
}VS Code CLI에 ProofCheck MCP 설치
$ code --add-mcp '{"name":"proofcheck","type":"http","url":"https://proofcheck.something-agent.workers.dev/mcp"}'Codex에 ProofCheck MCP 설치
$ codex mcp add proofcheck --url https://proofcheck.something-agent.workers.dev/mcpCodex config.toml에 ProofCheck MCP 설치
~/.codex/config.toml
[mcp_servers.proofcheck] url = "https://proofcheck.something-agent.workers.dev/mcp"
Gemini CLI에 ProofCheck MCP 설치
$ gemini mcp add -s user --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcpGemini settings.json에 ProofCheck MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"proofcheck": {
"url": "https://proofcheck.something-agent.workers.dev/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능something-agent/proofcheck is public and reachablegithub.com/something-agent/proofcheck ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-28github.com/something-agent/proofcheck ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 80 ms통과
README
GitHub에서 보기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 질문
ProofCheck MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http proofcheck https://proofcheck.something-agent.workers.dev/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
ProofCheck MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ProofCheck를 사용하려면 API key가 필요한가요?
아니요, 이 서비스는 무료로 사용할 수 있으며 API key가 필요하지 않습니다.
ProofCheck는 권한 부여에 대해 어떤 종류의 증거를 제공하나요?
did_web, dns_controllers, erc8004와 같은 방식을 사용하여 증거 강도를 평가하고, 서명자가 특정 서비스에 대한 권한이 있는지 판단합니다.
ProofCheck가 온체인 결제 완료 여부를 확인할 수 있나요?
아니요, 온체인 결제 완료 여부는 확인하지 않으며 서명된 아티팩트의 유효성만 검증합니다.
가능한 검증 결과(verdict)는 무엇인가요?
결과에는 valid_authorized, valid_signer_unproven, rejected, invalid_signature가 포함됩니다.