On this page

MCP

Cloud MCP server that exposes the same workspace operations as Public REST. MCP only calls the Public API with the user’s API key — it does not hold Gmail/Maps provider secrets.

Host: https://mcp.notiq.io

Canonical docs: https://docs.notiq.io. White-label vanity MCP must not advertise NotiQ docs.

Auth (resolution order)

MCP accepts any of:

X-API-Key: sk_live_…
Authorization: Bearer sk_live_…
Authorization: Bearer mcp_at_… — OAuth access token from the consent flow

Client	Typical method
Cursor	`X-API-Key` in MCP client headers
Claude / ChatGPT	OAuth — paste `sk_…` on the consent page (see Connect Claude / ChatGPT)

Rules:

Discovery / initialize / tools/list may omit a key; tools/call requires one.
Outbound REST always uses X-API-Key only (never Bearer, never mcp_at_).
Never ask the user to paste a key into chat.

Tools ↔ REST (1:1)

MCP tool	REST
`get_credits`	`GET /credits`
`list_accounts`	`GET /accounts`
`list_campaigns`	`GET /campaigns`
`create_campaign`	`POST /campaigns`
`get_campaign`	`GET /campaigns/:id`
`get_insights_overview`	`GET /insights/overview`
`get_recent_activity`	`GET /activity`
`start_campaign`	`POST /campaigns/:id/start`
`pause_campaign`	`POST /campaigns/:id/pause`
`list_leads`	`GET /campaigns/:id/leads`
`get_lead`	`GET /campaigns/:id/leads/:leadId`
`add_lead`	`POST /campaigns/:id/leads`
`add_leads_batch`	`POST /campaigns/:id/leads/batch`
`update_lead`	`PATCH /campaigns/:id/leads/:leadId`
`update_leads_batch`	`POST /campaigns/:id/leads/batch-update`
`delete_leads_batch`	`POST /campaigns/:id/leads/batch-delete`
`send_message`	`POST /inbox/messages`

Not shipped: LinkedIn tools.

Recipes

Goal	Tool call
Interested leads	`list_leads(tag="Interested")`
Waiting on you	`list_leads(needsReply=true)`
Excluded	`list_leads(excluded=true)`
Last reply	`get_recent_activity(type="reply_received")`
Best campaigns	`get_insights_overview` (recent sample, not all-time)
Large tag/exclude cleanup	`update_leads_batch` (max 100)
Permanent cleanup	`delete_leads_batch` (confirm first)

Argument schemas live on MCP tools/list after connect.

Credits & safety (for agents)

Only add_lead / add_leads_batch cost credits at call time (1 per create).
update_leads_batch / delete_leads_batch are 0 credits (delete does not refund).
Maps create_campaign discovery debits 1 credit per email lead found asynchronously.
Confirm with the user before delete_leads_batch, send_message, or start_campaign (real Gmail / irreversible).
Tool annotations: delete_leads_batch has destructiveHint: true and idempotentHint: true; send_message / start_campaign have destructiveHint: true.
Start with list_accounts and list_campaigns for ids; paginate with nextCursor.

Discovery endpoints (no auth)

Path	Role
`/health`	Liveness + whether Public API base is configured
`/, /.well-known/mcp.json`	Slim discovery JSON (tool names + blurbs)
`/.well-known/oauth-authorization-server`	OAuth AS metadata
`/.well-known/oauth-protected-resource`	OAuth resource metadata
`/llms.txt`	Short machine-readable summary
`/mcp`	Streamable HTTP MCP endpoint
`/authorize, /token, /register`	OAuth / DCR (Claude/ChatGPT style clients)

Connection tip (Cursor)

{
  "mcpServers": {
    "notiq": {
      "url": "https://mcp.notiq.io/mcp",
      "headers": {
        "X-API-Key": "sk_live_…"
      }
    }
  }
}

Create the key at /api-mcp.