{
  "markdown": "# HashProof\n\nVerifiable credentials with IPFS backup, on-chain registry, and pay-per-call API via x402.\n\n## What it is\n\nHashProof is a credential issuance API. Organizations and Individuals (entities) issue verifiable credentials to people. Each credential is:\n\n- Stored as a JSON in the database and backed up on IPFS (Pinata)\n- Registered on-chain in the `CredentialRegistry` contract on Celo\n- Verifiable via a public URL: `https://hashproof.dev/verify/:id`\n\nTwo 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.\n\n## Project structure\n\n```\nbackend/       Express API — credential issuance, verification, payments\nfrontend/      React app — landing page, credential verification, entity pages\ncontracts/     CredentialRegistry smart contract (Celo)\nmcp/           MCP server (hashproof-mcp on npm) — use HashProof from any AI agent\nskills/        Agent skill (npx skills add csacanam/hashproof)\ndocs/          Architecture and flow documentation\n```\n\n## Deployed contracts\n\n| Network      | Contract           | Address                                      |\n| ------------ | ------------------ | -------------------------------------------- |\n| Celo mainnet | CredentialRegistry | `0x7a1B759A602Aba72a70f99Dffd0a386d7504ce9B` |\n\n## Paid API endpoints\n\n| Endpoint                                  | Price      | Description                     |\n| ----------------------------------------- | ---------- | ------------------------------- |\n| `POST /issueCredential`                   | $0.10 USDC | Issue one verifiable credential |\n| `POST /entities/:id/verificationRequests` | $49 USDC | Submit a verification request   |\n\nPayment is in USDC on Base or Celo via x402. The client signs an off-chain authorization — no gas required.\n\n## Free endpoints\n\n| Endpoint                             | Description                                    |\n| ------------------------------------ | ---------------------------------------------- |\n| `GET /verify/:id`                    | Full 3-layer verification                      |\n| `GET /templates/:ref/requirements`   | Get required fields for a template             |\n| `POST /templates/:ref/preview`       | Generate a preview PDF with watermark (no cost) |\n| `GET /stats`                         | On-chain credential counters                   |\n\n## For AI agents\n\nHashProof is fully agent-usable — no account, no human onboarding. Three ways in:\n\n- **MCP server**, local or remote (listed on the [official MCP registry](https://registry.modelcontextprotocol.io) as `io.github.csacanam/hashproof`):\n\n  ```bash\n  # local (stdio) — pays per credential with your own wallet via x402, or an API key\n  claude mcp add hashproof -- npx -y hashproof-mcp\n\n  # remote (Streamable HTTP) — nothing to install, API key required to issue\n  claude mcp add --transport http hashproof https://api.hashproof.dev/mcp\n  ```\n\n  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`](mcp/README.md).\n\n- **Agent skill**: `npx skills add csacanam/hashproof` — or read it at [hashproof.dev/skill.md](https://hashproof.dev/skill.md).\n- **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](https://hashproof.dev/llms.txt).\n\nAgent identity metadata (ERC-8004 registration-v1): [hashproof.dev/metadata.json](https://hashproof.dev/metadata.json).\n\n## Quick start\n\nSee `backend/README.md` and `frontend/README.md` for setup instructions.\nSee [`docs/README.md`](./docs/README.md) for the full documentation index.\n",
  "bytes": 3934,
  "sha": "b465dca12baa972787b6a86625964527ad4abeedcee3c0d26ee524a17f6f6e55",
  "repo_slug": "csacanam/hashproof",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_csacanam_hashproof_bae0cfd8/readme"
}