English Français العربية

io.github.csacanam/hashproof

Registre officiel IA et agents

Issue verifiable credentials from AI agents for $0.10 via x402. On-chain on Celo, IPFS-pinned.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package hashproof-mcp
Claude Code 
claude mcp add hashproof -e 'HASHPROOF_API_KEY=<your hashproof_api_key>' -e 'HASHPROOF_WALLET_PRIVATE_KEY=<your hashproof_wallet_private_key>' -e 'HASHPROOF_X402_NETWORK=<HASHPROOF_X402_NETWORK>' -- npx -y hashproof-mcp@0.1.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "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": "<HASHPROOF_X402_NETWORK>"
            }
        }
    }
}

Variables d'environnement

  • HASHPROOF_API_KEY secret Prepaid API key (alternative to wallet). One of the two payment methods is required only for issue_credential.
  • HASHPROOF_WALLET_PRIVATE_KEY secret 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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. HashProof
  2. What it is
  3. Project structure
  4. Deployed contracts
  5. Paid API endpoints
  6. Free endpoints
  7. For AI agents
  8. Quick start

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

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

Deployed contracts

NetworkContractAddress
Celo mainnetCredentialRegistry0x7a1B759A602Aba72a70f99Dffd0a386d7504ce9B

Paid API endpoints

EndpointPriceDescription
POST /issueCredential$0.10 USDCIssue one verifiable credential
POST /entities/:id/verificationRequests$49 USDCSubmit a verification request

Payment is in USDC on Base or Celo via x402. The client signs an off-chain authorization — no gas required.

Free endpoints

EndpointDescription
GET /verify/:idFull 3-layer verification
GET /templates/:ref/requirementsGet required fields for a template
POST /templates/:ref/previewGenerate a preview PDF with watermark (no cost)
GET /statsOn-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):

    # 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.

Quick start

See backend/README.md and frontend/README.md for setup instructions. See docs/README.md for the full documentation index.

Questions fréquentes

Qu'est-ce que io.github.csacanam/hashproof ?

Issue verifiable credentials from AI agents for $0.10 via x402. On-chain on Celo, IPFS-pinned.

Comment installer io.github.csacanam/hashproof ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add hashproof -e 'HASHPROOF_API_KEY=<your hashproof_api_key>' -e 'HASHPROOF_WALLET_PRIVATE_KEY=<your hashproof_wallet_private_key>' -e 'HASHPROOF_X402_NETWORK=<HASHPROOF_X402_NETWORK>' -- npx -y hashproof-mcp@0.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.csacanam/hashproof ?

Oui. Il attend HASHPROOF_API_KEY, HASHPROOF_WALLET_PRIVATE_KEY, à renseigner dans sa configuration.

io.github.csacanam/hashproof est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.csacanam/hashproof ?

Il est publié par csacanam. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.