On this page

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.

ClientAuth
Claude / ChatGPTOAuth Sign-in → workspace key named MCP OAuth
Cursor / static MCPSeparate key from /api-mcp in X-API-Key
REST / scriptsAny 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:

RequestResponse
GET /Slim discovery JSON (what it is, how to connect, tool names)
GET /llms.txtSame overview as plain text
GET /.well-known/mcp.jsonSame discovery JSON
OAuth well-known / authorize pathsConnector handshake (Claude / ChatGPT)

Tool schemas and workspace data require a connected client (tools/list / tools/call with auth).

Tools ↔ REST (40)

MCP toolRESTCredits
get_creditsGET /credits0
get_setup_statusGET /setup0
list_accountsGET /accounts0
list_campaignsGET /campaigns0
get_campaignGET /campaigns/:id0
get_insights_overviewGET /insights/overview0
get_recent_activityGET /activity0
start_campaignPOST /campaigns/:id/start0
pause_campaignPOST /campaigns/:id/pause0
create_lookalike_campaignPOST /campaigns/lookalikeLookalike allowance
list_leadsGET /campaigns/:id/leads0
get_leadGET /campaigns/:id/leads/:leadId0
add_leadPOST /campaigns/:id/leads1 if inserted
add_leads_batchPOST /campaigns/:id/leads/batch1 per create (max 100)
update_leadPATCH /campaigns/:id/leads/:leadId0
update_leads_batchPOST /campaigns/:id/leads/batch-update0 (max 100)
delete_leads_batchPOST /campaigns/:id/leads/batch-delete0 (max 100; irreversible)
send_messagePOST /inbox/messages0
lookup_profilePOST /linkedin/profiles/lookup0
search_linkedinPOST /linkedin/search0
search_linkedin_untilpaced loop of POST /linkedin/search (MCP-only; targetCount max 50)0
list_templatesGET /templates0
get_templateGET /templates/:id0
assign_templatePOST /campaigns/:id/template0
list_tagsGET /tags0
create_tagPOST /tags0
update_tagPATCH /tags/:labelKey0
create_manual_campaignPOST /campaigns0
rename_campaignPATCH /campaigns/:id0
delete_campaignDELETE /campaigns/:id0 (irreversible)
delete_leadDELETE /campaigns/:id/leads/:leadId0 (irreversible)
create_templatePOST /templates0
update_account_limitsPATCH /accounts/:id/limits0
create_linkedin_connect_linkPOST /accounts/connect-link0
disconnect_linkedin_for_reconnectPOST /accounts/:id/disconnect-for-reconnect0
create_linkedin_reconnect_linkPOST /accounts/:id/reconnect-link0
delete_accountDELETE /accounts/:id0 (irreversible)
preview_leadPOST /campaigns/:id/leads/:leadId/preview0
update_templatePATCH /templates/:id0
delete_templateDELETE /templates/:id0 (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 on targetCount (max 50), daily quota, no more results, ~90s time budget, or page cap.
  • Inputs: accountId, exactly one of query / url, targetCount (1–50), optional type / limit / cursor.
  • Returns: items, fetched, targetCount, pagesFetched, cursor, stoppedReason, resumeHint (plus errorCode / errorMessage when stopped on error).
  • stoppedReason: target_reached | no_more_results | daily_quota | rate_limited | time_budget | page_cap | error
  • Resume only when stoppedReason is time_budget or page_cap (and short rate_limited cases that return a cursor) and cursor is set — same query/url + that cursor. Do not resume after target_reached, no_more_results, daily_quota, or hard error.
  • Does not save leads, spend ScaliQ lead credits, or start a campaign. Import with add_leads_batch using linkedinUrls (1 credit per create). See POST /linkedin/search.

Cost & safety hints

Hosts use MCP annotation hints to decide what to auto-approve.

GroupNotes
Reads (get_*, list_*, preview_lead)Read-only; safe to auto-approve
add_lead / add_leads_batchCharges 1 credit per successful create
create_lookalike_campaignUses Lookalike allowance; searches people from a public profile (does not message)
lookup_profile / search_linkedin / search_linkedin_untilLive LinkedIn; each person returned spends lookup/search quota (idempotentHint: false)
start_campaignStarts real outreach pacing — confirm with the user
send_messageSends a LinkedIn DM that cannot be recalled — confirm
delete_* / delete_leads_batch / delete_accountPermanent — destructiveHint: true; confirm
update_lead / update_leads_batchOverwrites existing lead fields (tag / exclude / CRM)

Demo prompts

AskTool / path
Is my workspace ready?get_setup_status
Connect LinkedIncreate_linkedin_connect_link → user opens connectUrl
Find ~40 prospects matching my ICPsearch_linkedin_until with targetCount; resume with cursor only if stoppedReason is time_budget or page_cap
Set up my first campaignFollow 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