reference.mdx

title	Build
sidebarTitle	Build
description	Get started building with Proofable.
icon	book

Pick the surface that matches the caller. The table below maps each one to its endpoint and its sign-in method.

Surface	Use it for	Endpoint or package	Signs in with
MCP	Any app, chat, or agent that speaks MCP	https://mcp.proofable.me/mcp	OAuth, or an access key
JavaScript SDK	Apps, backends, and React	@proofable/sdk	Hosted sign-in, or an access key on servers
CLI	Terminal setup and agent context	npx -y @proofable/sdk	OAuth, or an access key
HTTP API	Any language or backend	https://api.proofable.me	Signed requests, a session, or an access key

Rules for every integration

• Browsers use the SDK or Hosted Verify. Never put secrets or hand-built auth headers in browser code. Proxy through your server instead.
• Servers run gate checks, raw HTTP, and anything that needs a credential.
• Access keys (npk_*) belong on servers and in CI only. Never use a wallet private key as an MCP credential. Access keys
• 402 responses carry a quote. Pay per call with x402, or add credits and retry.
• Proof IDs and URLs come from responses. Never construct or guess one.

Machine-readable exports

Resource	URL
OpenAPI	https://api.proofable.me/openapi.json
Page index	https://docs.proofable.me/llms.txt
Full docs	https://docs.proofable.me/llms-full.txt
MCP discovery	https://mcp.proofable.me/.well-known/mcp.json

This docs site also serves a search-only MCP endpoint at https://docs.proofable.me/mcp. It searches these pages. Your profile, proofs, and agents live at https://mcp.proofable.me/mcp.

Sections

Tools, sign-in, and discovery. Client, gates, agents, widgets, and CLI. Endpoints, authentication, errors, and limits. Every check and its inputs.