io.github.csacanam/hashproof — Model Context Protocol (MCP) Server

The io.github.csacanam/hashproof MCP server provides access to a HashProof credential issuance API. It supports issuing verifiable credentials by issuing entities to people, including JSON storage backed on IPFS and on-chain registration on Celo.

🛠️ Key Features

Issues verifiable credentials from AI agents
Pay-per-call API using x402 with USDC micropayments (Base or Celo)
On-chain registry in the CredentialRegistry smart contract on Celo
JSON credential storage with IPFS backup (Pinata)
Public verification URL format: https://hashproof.dev/verify/:id
Mentions enterprise prepaid API key option (in addition to x402 micropayments)

🚀 Use Cases

Issuing verifiable credentials for organizations and individuals
Verifying credentials via a public URL
Funding API calls without API keys or subscriptions (x402 micropayments)

⚡ Developer Benefits

No API keys or subscriptions required for x402 micropayments
Public verification endpoint using an ID

⚠️ Limitations

Describes on-chain registration specifically on Celo (not other chains)
No additional tooling, capabilities, or MCP-specific endpoints are provided in the supplied data

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 CredentialRegistry contract 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

code

backend/       Express API — credential issuance, verification, payments
frontend/      React app — landing page, credential verification, entity pages
contracts/     CredentialRegistry smart contract (Celo)
mcp/           MCP server (hashproof-mcp on npm) — use HashProof from any AI agent
skills/        Agent skill (npx skills add csacanam/hashproof)
docs/          Architecture and flow documentation

Network

Contract

Address

Celo mainnet

CredentialRegistry

0x7a1B759A602Aba72a70f99Dffd0a386d7504ce9B

Endpoint

Price

Description

POST /issueCredential

$0.10 USDC

Issue one verifiable credential

POST /entities/:id/verificationRequests

$49 USDC

Submit a verification request

Endpoint

Description

GET /verify/:id

Full 3-layer verification

GET /templates/:ref/requirements

Get required fields for a template

POST /templates/:ref/preview

Generate a preview PDF with watermark (no cost)

GET /stats

On-chain credential counters

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):

bash

# local (stdio) — pays per credential with your own wallet via x402, or an API key
claude mcp add hashproof -- npx -y hashproof-mcp

# remote (Streamable HTTP) — nothing to install, API key required to issue
claude mcp add --transport http hashproof https://api.hashproof.dev/mcp

Tools: preview_template (free — iterate custom layouts), issue_credential ($0.10 via x402 or API key), verify_credential and get_template_requirements (free). The remote server has no wallet, so it can't do x402 — it needs Authorization: Bearer <api-key>. See mcp/README.md.

Agent skill: npx skills add csacanam/hashproof — or read it at hashproof.dev/skill.md.

Plain HTTP + x402: POST /issueCredential returns 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.

Install

Configuration

Environment variables

HASHPROOF_API_KEYsecret

Prepaid API key (alternative to wallet). One of the two payment methods is required only for issue_credential.

HASHPROOF_WALLET_PRIVATE_KEYsecret

EVM private key of a dedicated wallet holding USDC on Base or Celo — pays $0.10 per issuance via x402.

HASHPROOF_X402_NETWORK

base (default) or celo

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hashproof": {
      "command": "npx",
      "args": [
        "-y",
        "hashproof-mcp@0.1.2"
      ],
      "env": {
        "HASHPROOF_API_KEY": "<YOUR_HASHPROOF_API_KEY>",
        "HASHPROOF_WALLET_PRIVATE_KEY": "<YOUR_HASHPROOF_WALLET_PRIVATE_KEY>",
        "HASHPROOF_X402_NETWORK": "<YOUR_HASHPROOF_X402_NETWORK>"
      }
    }
  }
}

io.github.csacanam/hashproof