Developers

Model Context Protocol (MCP) for ClientProof.

Agents can call the same read-only jobs as your dashboard: list clients, fetch collection links, inspect testimonial queues, and return embed snippets. Publishing quotes and changing billing still happen in the dashboard.

Agent-oriented index: /llms.txt · Markdown twin

Connect

Log in to your agency account and open Dashboard → MCP to create a rotatable MCP agent API key from Dashboard → MCP.
Point your agent HTTP client at POST https://useclientproof.com/api/mcp with Authorization: Bearer <your key>, or use a studio session cookie. Call GET /api/mcp for the catalog JSON, or openapi.json for a minimal OpenAPI description.
Send JSON-RPC tools/list and tools/call methods (see response shapes in the GET catalog).

Revoked keys stop working immediately. Last-used timestamps are visible in the dashboard.

Install snippets

Replace the Bearer token with a rotatable Pro-plan key from Dashboard → MCP ($29/mo). Free and demo studios can call the same URL with a session cookie instead. Streamable HTTP: POST JSON-RPC initialize, tools/list, and tools/call; GET returns the catalog or an SSE keepalive when authenticated. Unauthenticated calls receive HTTP 401 with OAuth protected-resource metadata. Approving testimonials and billing changes stay in the dashboard UI.

Cursor (~remote HTTP MCP)

{
  "mcpServers": {
    "clientproof": {
      "url": "https://useclientproof.com/api/mcp",
      "headers": {
        "Authorization": "Bearer cp_mcp_REPLACE_WITH_DASHBOARD_KEY"
      }
    }
  }
}

Claude Desktop (via mcp-remote bridge)

{
  "mcpServers": {
    "clientproof": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://useclientproof.com/api/mcp",
        "--header",
        "Authorization: Bearer cp_mcp_REPLACE_WITH_DASHBOARD_KEY"
      ]
    }
  }
}

Tool catalog

list_clients
List every client workspace in the authenticated agency account. Use when you need slugs before get_collect_link, list_testimonials, or get_wall_embed_snippet. Do not use when you already know the slug. Side effects: none. Returns up to all clients (no pagination). Example: { clients: [{ name, slug, accent }] }.
Risk: read · readOnlyHint · Illustrative billable units per call: 1
get_collect_link
Return the public testimonial collection URL for one client workspace. Use when an agent should open or share the /c/{slug} form. Do not use for embed HTML (use get_wall_embed_snippet) or moderation (use list_testimonials). Required: slug from list_clients. Side effects: none.
Risk: read · readOnlyHint · Illustrative billable units per call: 1
list_testimonials
List up to 50 testimonials for a client, newest first (no cursor pagination yet). Use when reviewing queue state or finding approved quotes. Do not use to approve/reject (dashboard only). Optional status: PENDING, APPROVED, or REJECTED. Required: slug. Side effects: none.
Risk: read · readOnlyHint · Illustrative billable units per call: 1
get_wall_embed_snippet
Return copy-paste script and iframe snippets for the Wall of Love embed. Use when wiring a site with approved testimonials only. Do not use for collection links (get_collect_link) or pending queue review (list_testimonials with status PENDING). Required: slug. Side effects: none; does not change embed settings.
Risk: read · readOnlyHint · Illustrative billable units per call: 2

Pricing & entitlements

Pro ($29/mo) — rotatable MCP agent keys, all read-only tools, 5,000 included billable actions per UTC month when metering is enabled.
Free — session cookie only (no agent keys), read-only tools, lower rate limits.
Demo — log into Northline Studio, then call POST /api/mcp with your session cookie (same read-only tools, tight limits).

MCP is included in your Pro seat ($29/mo on useclientproof.com via Stripe) — not a separate add-on. Pro includes read-only agent tools, rotatable MCP agent API keys, and 5,000 included billable actions per UTC month when usage metering is turned on. Until then, fair use applies through per-plan rate limits. Free accounts can call the same read-only tools with a studio session (no agent keys). The shared demo at /demo uses Northline Studio the same way.

Discovery JSON at GET /api/mcp includes an entitlements object and metering metadata. Upgrade from /pricing.

Consumption & limits

When metering is on, usage receipts appear in Dashboard → MCP. Soft fair use (rate limits) applies today; hard monthly caps apply only after usage metering is enabled on the service. Heavy use may return HTTP 429 with retry_after.

Transport & auth probes

Streamable HTTP at /api/mcp (POST JSON-RPC initialize, notifications/initialized, tools/list, tools/call; GET catalog or authenticated SSE). Include Accept: application/json, text/event-stream on POST when your client sends an Accept header. Unauthenticated tool calls return HTTP 401 with WWW-Authenticate pointing at /.well-known/oauth-protected-resource. Agent access uses Bearer tokens from Dashboard → MCP (not a live OAuth authorization code flow on this host yet).

Official MCP Registry & Smithery prep

Not published or listed on Smithery yet. Draft namespace com.useclientproof/clientproof, server.json, DNS/HTTP verify steps, and aggregator checklist live in docs/mcp-registry.md (repo). Discovery card: /.well-known/mcp/server-card.json.

401 (not 403) on unauthenticated MCP POST with PRM in WWW-Authenticate
Public tool catalog at GET /api/mcp
Scanner-friendly responses; no claim of Smithery listing until a human submits

Start with the human UI

Create the agency account, add clients, then wire agents with rotatable keys.

Start free See how it works Try the demo Upgrade $29/mo Log in Help center

New account, then billing: sign up and open billing. Existing studio: log in to billing.

Prefer clicking through a seeded studio? Try the demo opens Northline Studio in one click. Manual login details stay on /demo only.