
Hashproof
io.github.csacanamPublished by GitHub account csacanamv0.1.2Updated Oct 24, 2026
Issue verifiable credentials from AI agents for $0.10 via x402. On-chain on Celo, IPFS-pinned.
Overview
HashProof's local MCP server lets an AI assistant preview credential templates, issue verifiable credentials for $0.10 in USDC, and verify credentials.
- What you can do
- Preview credential templates and generate watermarked preview PDFs at no cost, and look up the required fields for a template by reference. Issue a verifiable credential, paid per call in USDC via x402 or with a prepaid API key. Verify a credential through the three-layer check and read on-chain credential counters. Issued credentials are stored as JSON, backed up on IPFS and registered in a Celo smart contract.
- When to use it
- Use it when an assistant needs to create or check verifiable credentials, such as issuing a certificate to a person or confirming that an existing credential is valid, without a human onboarding flow.
- Requirements
- Runs locally as an npm package over stdio via npx, so Node.js is needed. Issuing requires one of two payment methods: HASHPROOF_API_KEY (prepaid key) or HASHPROOF_WALLET_PRIVATE_KEY (an EVM wallet holding USDC on Base or Celo). HASHPROOF_X402_NETWORK selects base (default) or celo. Network access is needed for the API, IPFS and Celo.
Installation
In SourceWeft
- Open Hashproof in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
HashProof
Verifiable credentials with IPFS backup, on-chain registry, and pay-per-call API via x402.
What it is
HashProof is a credential issuance API. Organizations and Individuals (entities) issue verifiable credentials to people. Each credential is:
- Stored as a JSON in the database and backed up on IPFS (Pinata)
- Registered on-chain in the
CredentialRegistrycontract on Celo - Verifiable via a public URL:
https://hashproof.dev/verify/:id
Two ways to pay: micropayment in USDC via x402 (Base or Celo) — no API keys, no subscriptions — or a prepaid API key for enterprise clients (no crypto needed). AI agents can call the API directly using a funded wallet.
Project structure
Deployed contracts
Paid API endpoints
Payment is in USDC on Base or Celo via x402. The client signs an off-chain authorization — no gas required.
Free endpoints
For AI agents
HashProof is fully agent-usable — no account, no human onboarding. Three ways in:
-
MCP server, local or remote (listed on the official MCP registry as
io.github.csacanam/hashproof):Tools:
preview_template(free — iterate custom layouts),issue_credential($0.10 via x402 or API key),verify_credentialandget_template_requirements(free). The remote server has no wallet, so it can't do x402 — it needsAuthorization: Bearer <api-key>. Seemcp/README.md. -
Agent skill:
npx skills add csacanam/hashproof— or read it at hashproof.dev/skill.md. -
Plain HTTP + x402:
POST /issueCredentialreturns a 402 challenge any x402-v2 client can pay (USDC on Base or Celo). LLM index: hashproof.dev/llms.txt.
Agent identity metadata (ERC-8004 registration-v1): hashproof.dev/metadata.json.
Quick start
See backend/README.md and frontend/README.md for setup instructions.
See docs/README.md for the full documentation index.
Source: README.md at commit 67aff5e
Tools
0Version history
1- v0.1.2LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.