MCP
Drive the ScaliQ Public API from Cursor, Claude, ChatGPT, and other MCP clients. Tools are mostly 1:1 with REST under /public/v1, plus MCP-only search_linkedin_until (paced multi-page POST /linkedin/search).
URL
MCP: https://mcp.scaliq.ai
Connect
Cursor (API key header)
Create a key on API & MCP (any name other than MCP OAuth). Put it in mcp.json:
{
"mcpServers": {
"scaliq": {
"url": "https://mcp.scaliq.ai",
"headers": {
"X-API-Key": "sk_live_..."
}
}
}
}
Use a sk_live_… key. Never put the OAuth-minted MCP OAuth key here — reconnecting Claude rotates it.
Claude / ChatGPT (OAuth Sign-in)
Remote connectors use Sign in with ScaliQ. Leave Advanced OAuth Client ID / Secret blank. After Connect, review Allow access? then Allow. Field-by-field: Connect Claude / ChatGPT.
| Client | Auth |
|---|---|
| Claude / ChatGPT | OAuth Sign-in → workspace key named MCP OAuth |
| Cursor / static MCP | Separate key from /api-mcp in X-API-Key |
| REST / scripts | Any workspace key via X-API-Key |
Accept header
MCP clients must send an Accept header that includes both application/json and text/event-stream on tool calls (Streamable HTTP). Plain browser GETs without that Accept value receive a short discovery overview instead of the transport.
Inspect without a key
These need no API key:
| Request | Response |
|---|---|
GET / | Slim discovery JSON (what it is, how to connect, tool names) |
GET /llms.txt | Same overview as plain text |
GET /.well-known/mcp.json | Same discovery JSON |
| OAuth well-known / authorize paths | Connector handshake (Claude / ChatGPT) |
Tool schemas and workspace data require a connected client (tools/list / tools/call with auth).
Tools ↔ REST (40)
| MCP tool | REST | Credits |
|---|---|---|
get_credits | GET /credits | 0 |
get_setup_status | GET /setup | 0 |
list_accounts | GET /accounts | 0 |
list_campaigns | GET /campaigns | 0 |
get_campaign | GET /campaigns/:id | 0 |
get_insights_overview | GET /insights/overview | 0 |
get_recent_activity | GET /activity | 0 |
start_campaign | POST /campaigns/:id/start | 0 |
pause_campaign | POST /campaigns/:id/pause | 0 |
create_lookalike_campaign | POST /campaigns/lookalike | Lookalike allowance |
list_leads | GET /campaigns/:id/leads | 0 |
get_lead | GET /campaigns/:id/leads/:leadId | 0 |
add_lead | POST /campaigns/:id/leads | 1 if inserted |
add_leads_batch | POST /campaigns/:id/leads/batch | 1 per create (max 100) |
update_lead | PATCH /campaigns/:id/leads/:leadId | 0 |
update_leads_batch | POST /campaigns/:id/leads/batch-update | 0 (max 100) |
delete_leads_batch | POST /campaigns/:id/leads/batch-delete | 0 (max 100; irreversible) |
send_message | POST /inbox/messages | 0 |
lookup_profile | POST /linkedin/profiles/lookup | 0 |
search_linkedin | POST /linkedin/search | 0 |
search_linkedin_until | paced loop of POST /linkedin/search (MCP-only; targetCount max 50) | 0 |
list_templates | GET /templates | 0 |
get_template | GET /templates/:id | 0 |
assign_template | POST /campaigns/:id/template | 0 |
list_tags | GET /tags | 0 |
create_tag | POST /tags | 0 |
update_tag | PATCH /tags/:labelKey | 0 |
create_manual_campaign | POST /campaigns | 0 |
rename_campaign | PATCH /campaigns/:id | 0 |
delete_campaign | DELETE /campaigns/:id | 0 (irreversible) |
delete_lead | DELETE /campaigns/:id/leads/:leadId | 0 (irreversible) |
create_template | POST /templates | 0 |
update_account_limits | PATCH /accounts/:id/limits | 0 |
create_linkedin_connect_link | POST /accounts/connect-link | 0 |
disconnect_linkedin_for_reconnect | POST /accounts/:id/disconnect-for-reconnect | 0 |
create_linkedin_reconnect_link | POST /accounts/:id/reconnect-link | 0 |
delete_account | DELETE /accounts/:id | 0 (irreversible) |
preview_lead | POST /campaigns/:id/leads/:leadId/preview | 0 |
update_template | PATCH /templates/:id | 0 |
delete_template | DELETE /templates/:id | 0 (irreversible) |
List tools that accept limit / cursor surface nextCursor — follow it when present. Same plan gate and rate limits as REST (Credits & rate limits).
MCP-only: search_linkedin_until
Prefer when the user asks for N people / “more prospects.” For a single page, use search_linkedin.
- Internally paces
POST /linkedin/search(~16s between pages). Stops ontargetCount(max 50), daily quota, no more results, ~90s time budget, or page cap. - Inputs:
accountId, exactly one ofquery/url,targetCount(1–50), optionaltype/limit/cursor. - Returns:
items,fetched,targetCount,pagesFetched,cursor,stoppedReason,resumeHint(pluserrorCode/errorMessagewhen stopped on error). stoppedReason:target_reached|no_more_results|daily_quota|rate_limited|time_budget|page_cap|error- Resume only when
stoppedReasonistime_budgetorpage_cap(and shortrate_limitedcases that return a cursor) andcursoris set — samequery/url+ that cursor. Do not resume aftertarget_reached,no_more_results,daily_quota, or harderror. - Does not save leads, spend ScaliQ lead credits, or start a campaign. Import with
add_leads_batchusinglinkedinUrls (1 credit per create). See POST /linkedin/search.
Cost & safety hints
Hosts use MCP annotation hints to decide what to auto-approve.
| Group | Notes |
|---|---|
Reads (get_*, list_*, preview_lead) | Read-only; safe to auto-approve |
add_lead / add_leads_batch | Charges 1 credit per successful create |
create_lookalike_campaign | Uses Lookalike allowance; searches people from a public profile (does not message) |
lookup_profile / search_linkedin / search_linkedin_until | Live LinkedIn; each person returned spends lookup/search quota (idempotentHint: false) |
start_campaign | Starts real outreach pacing — confirm with the user |
send_message | Sends a LinkedIn DM that cannot be recalled — confirm |
delete_* / delete_leads_batch / delete_account | Permanent — destructiveHint: true; confirm |
update_lead / update_leads_batch | Overwrites existing lead fields (tag / exclude / CRM) |
Demo prompts
| Ask | Tool / path |
|---|---|
| Is my workspace ready? | get_setup_status |
| Connect LinkedIn | create_linkedin_connect_link → user opens connectUrl |
| Find ~40 prospects matching my ICP | search_linkedin_until with targetCount; resume with cursor only if stoppedReason is time_budget or page_cap |
| Set up my first campaign | Follow Agent setup |
| When did I get the last reply? | get_recent_activity with type=reply_received |
| Who’s Interested? | list_leads with tag=Interested |
| Who needs me? | list_leads with needsReply=true |
| Best campaign? | get_insights_overview |