API · MCP · Works with Claude

Connect Claude to ClinchRev

Drive your ClinchRev workspace from Claude or any LLM. Review leads and calls, read your AI agent's script, and build & run phone and email outreach — through the ClinchRev MCP server or the REST API.

Works with Claude (MCP)

Add the hosted MCP server at https://mcp.clinchrev.com/mcp in Claude Desktop or Claude Code. Ask Claude to review calls or launch a campaign in plain English.

Scoped & secure

Each API key maps to one user and only ever accesses that user's workspace data. Keys are revocable, and actions that spend money or contact people are confirmation-gated.

Fair rate limits

1,000 requests/hour with a 60/minute burst, per key. Exceeding it returns HTTP 429 with a Retry-After header.

Authentication

Create an API key in Dashboard → Settings → Integrations. Send it on every request in either header:

X-API-Key: clr_ab12cd34_your_secret
# or
Authorization: Api-Key clr_ab12cd34_your_secret

The key identifies exactly one user; every response is scoped to that user's workspace(s). Requesting another user's record returns 404. Building an AI agent? Hand it the machine-readable schema at https://clinchrev.com/api/public/openapi.json.

Add ClinchRev to Claude

Option 1 · Claude Code (CLI)

claude mcp add --transport http clinchrev \
  https://mcp.clinchrev.com/mcp \
  --header "X-API-Key: <your key>"

Option 2 · Claude Desktop

Settings → Developer → Edit Config, add this, then restart Claude:

{
  "mcpServers": {
    "clinchrev": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.clinchrev.com/mcp",
        "--header", "X-API-Key:${CLINCHREV_KEY}"
      ],
      "env": { "CLINCHREV_KEY": "<your key>" }
    }
  }
}

Then ask Claude to “list my ClinchRev leads” or build and launch a campaign. Claude.ai web connectors currently require OAuth — use one of the options above.

What you can do

MethodEndpointPurpose
GET/leads/List & filter leads
GET/companies/{id}/Read an AI agent's call script
GET/campaigns/{id}/Campaign + full sequence (steps, A/B copy)
POST/campaigns/Create a phone or email campaign (draft)
POST/sequence-steps/Add an email / call / wait step
PATCH/campaigns/{id}/Run, pause, resume or stop a campaign
GET/calls/Review call logs, outcomes & transcripts
GET/dashboard/Pipeline stats

Full request/response details, live "try it out", and code samples in every language are in the interactive reference.

Interactive API reference

Browse every endpoint, authenticate with your key, and run live requests — with ready-to-copy cURL, Python, Node.js, Ruby and PHP snippets.