Skip to main content
Start with the smallest source that answers the task. Use the text export for model context and the linked reference page for exact fields.

Read first

  1. Home — hosted MCP endpoint, then Connect
  2. Connect Proofable — chat, IDEs, jobs, listings, and proofs
  3. Agent setup to set identity and permissions
  4. MCP tools for exact tool behavior
  5. Trust for checks and reusable proofs
  6. Standards & interoperability for how Proofable uses existing protocols

MCP

Product server: https://mcp.proofable.me/mcp for profile, proofs, listings, permissions, agents, and private context. Not the product: https://docs.proofable.me/mcp for documentation search only (Mintlify).
  1. Register https://mcp.proofable.me/mcp in the host (marketplace, registry, or URL-only config).
  2. Click Connect in the host.
  3. Follow Connect Proofable and the MCP workflow. Reuse proofs before you verify again.
Profile access keys (npk_*) are for servers and CI only.

Rules

  • Browser → Proofable: SDK (ProofableClient, widgets) or Hosted Verify. Do not call api.proofable.me from the browser with secrets or ad-hoc headers; use a server proxy when you need custom server-side calls.
  • Server → Proofable: gateCheck, eligibility, secrets, raw HTTP. API overview
  • Profiles, agents, listings, gates, and proofs: Ecosystem
  • Default hosted sign-in: Hosted Verify. Optional in-app signing: Signing format
  • Do not use wallet private keys as MCP credentials. Sign in with OAuth or use Profile access keys (npk_*) for Bearer in MCP or server config only.
  • 402: use the x402 retry pattern
  • Agents: Overview, Agent setup, Discover agents
  • Use returned proof URLs or qHashes only when the API/tool response provides them.

Exports

MCP JSON

Hosts that omit the spec type field (including Cursor) use a URL-only entry inside mcpServers and discover OAuth from the server’s 401 challenge:
Hosts that require the spec type field use type: "http":
Jump to MCP overview, MCP setup, or the HTTP API when you need detail beyond this reading order.
Last modified on September 8, 2026