Skip to main content
Both send Authorization: Bearer <token> to https://mcp.proofable.me/mcp.

Sign in

  1. Register https://mcp.proofable.me/mcp once (plugin, registry listing, or URL-only MCP config).
  2. Start the sign-in in the client’s MCP panel.
The terminal installer writes the same URL:
Adding Proofable to a client asks you to sign in straight away. A request with no credential returns 401 with a WWW-Authenticate challenge on every method, initialize included, and that challenge is what opens the host’s OAuth flow (DCR, PKCE and token exchange). Claude shows a Connect button in the chat and runs the call once you sign in. In Claude Code, run /mcp. In Codex, run codex mcp login proofable.
An expired or invalid Bearer gets the same challenge on every request, including initialize, so OAuth-capable hosts refresh silently. The endpoint is stateless streamable HTTP: GET and DELETE on /mcp return 405 without a challenge. Without an account, proofable_context, proofable_verifiers_catalog, proofable_proofs_check and proofable_verify_or_guide run on https://mcp.proofable.me/mcp/public. That is the anonymous surface directory listings and account-free checks use. Anything that needs a profile is challenged there too, so a client that lands on it signs in and moves to /mcp. MCP OAuth covers discovery, token exchange and scopes.

Access key (servers and automation)

Create an access key in Access Keys, set it as an environment variable, and let the CLI write the config:
Or paste the block into any client’s MCP settings:
Marketplace gateways that reserve Authorization for their own OAuth forward the same key as x-proofable-access-key. It is the same npk_* key, profile and revocation path. Leave the gateway’s key field empty to use the host’s own sign-in instead.

Disconnect

An OAuth token is revoked through the OAuth revocation endpoint. An npk_* key is revoked through the Proofable API, and the CLI then removes the local MCP header from configured clients.

Interactive verification

Passkey, wallet, OAuth and social verification steps run on Hosted Verify. When a tool returns hostedVerifyUrl, open it once, then continue in MCP.

Security

Last modified on November 7, 2026