Skip to main content
POST https://instantcampaign.ai/api/mcp is a stateless MCP server that uses the Streamable HTTP transport. It authenticates with a workspace API key that has the mcp scope, or with a key that has no scopes.
To use it from an MCP client, add a remote (HTTP) server with the URL above and the header Authorization: Bearer ic_YOUR_KEY.

Protocol

  • Methods: initialize, ping, tools/list and tools/call. Supported protocol versions are 2025-06-18, 2025-03-26 and 2024-11-05.
  • Each POST gets a single JSON response. There is no SSE stream and no session ID, and GET and DELETE answer 405.
  • Send one JSON-RPC message per request, not a batch. A notification (a message with no id) gets an empty 202.
  • The limit is 60 requests/minute per workspace, and bodies are capped at 1 MB.

Tools

The tools act on the key’s workspace with member-level permissions:
  • Read: workspace overview, templates and a rendered preview, campaigns (list, detail with sends, performance, plan, A/B results, proposals), automations (list, detail with steps and executions), lists, segments, custom fields, an audience estimate, signup forms, landing pages, the message log, one contact’s subscription status, email analytics (overview, breakdown by dimension, engagement by weekday and hour), website analytics, Ad Studio results, deliverability and sending setup, the setup guide, usage and brand configuration.
  • Write: draft or duplicate a template, generate copy or an image, create a campaign from a brief (its plan waits for approval in the app), create a draft journey from a description, create a list, create or update a contact, add it to or remove it from a list, unsubscribe it, and record an event or goal.
No tool sends or schedules email. Personal data in tool results is redacted before it reaches the client, and the tools that take an email address never return it. Call tools/list for the current list and each tool’s input schema.