MCP server

Endpoint

Authentication

Connect in one of two ways; both resolve to the same (workspace, scopes) principal:

• API key: send Authorization: Bearer rhq_live_… with each request. Best for your own scripts and headless clients.
• OAuth connector: for end-user apps. On an unauthenticated request the server returns 401 with a WWW-Authenticate header pointing at /.well-known/oauth-protected-resource; the client discovers the authorization server, the user consents to scopes in the browser, and the issued token is sent as a bearer token.

Connect Claude / ChatGPT

In a host that supports remote MCP connectors (Claude.ai and Claude Desktop › Settings › Connectors › Add custom connector; ChatGPT custom connectors), add the URL below. The OAuth flow runs in your browser and you approve the scopes:

https://api.reachhq.io/mcp

For a programmatic MCP client that authenticates with an API key, point it at the Streamable HTTP endpoint:

{
  "mcpServers": {
    "reachhq": {
      "type": "http",
      "url": "https://api.reachhq.io/mcp",
      "headers": { "Authorization": "Bearer rhq_live_xxx" }
    }
  }
}

Calling tools

The endpoint speaks JSON-RPC 2.0. You can call a tool over plain HTTP; include an Accept header that allows text/event-stream for Streamable HTTP:

curl -X POST https://api.reachhq.io/mcp \
  -H "Authorization: Bearer rhq_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
        "params": { "name": "campaigns_list", "arguments": { "pageSize": 10 } } }'

Limits & behaviour

• Rate limit: 240 requests per 60 seconds per credential.
• JSON results: every tool returns JSON; large results are truncated at 25,000 characters, so narrow your query for big datasets.
• Safe sends: send tools require an idempotency key and run suppression checks, so an assistant can never double-send or email a suppressed recipient.
• Stateless: each request is independently authenticated and scoped.

Tool catalogue

All 94 tools, grouped by domain. Scope is the minimum scope to see the tool; tools that bundle multiple actions re-check a write scope per action. You only see the tools your credential is scoped for.

Campaigns

Recipients

Leads

Lists & custom fields

Deals

Mailboxes

Warmup

Inbox

AI inbox agent

Deliverability

Verification

Webhooks

CRM

Analytics

Account & workspace

Members & invites

Billing

Agency

Lead search