# Instantly MCP: Run Cold Email from Claude and ChatGPT > Connect Instantly to Claude, ChatGPT, Cursor or Codex with one MCP server: all 268 Instantly API v2 operations, a three-step setup and prompts to paste. Page: https://flymy.ai/blog/instantly-mcp-guide/ [Blog](https://flymy.ai/blog/) / Instantly MCP Guide ยท MCP # Instantly MCP: run your cold email from Claude, ChatGPT and AI agents Connect Instantly to Claude, ChatGPT, Cursor or Codex through the FlyMy.AI MCP and your assistant gets the whole Instantly API v2: 268 actions for campaigns, leads, Unibox replies, analytics, webhooks, SuperSearch and Instantly's AI agents. The setup in three steps, prompts to paste, what happens before it sends or spends, and how it compares with Instantly's own MCP server. By **the FlyMy.AI team** 13 November 2026 16 min read ![Illustration with example data: in Claude, the FlyMy.AI MCP answers which Instantly campaigns got the most replies this week with a bar chart, next to a Unibox reply waiting for approval, a reply_received webhook and a warmup health score of 98.](https://flymy.ai/blog/instantly-mcp-guide/img/hero-1200.jpg) In short - **The Instantly MCP lets an AI assistant work in your Instantly workspace.** Ask Claude, ChatGPT, Cursor or Codex in plain words to report on campaigns, sort Unibox replies, import leads or set up webhooks. - **New on 13 November 2026: the whole Instantly API v2 on FlyMy.AI.** 268 actions, one for each operation of Instantly's public API reference in 37 groups, up from 27. - **Three steps to set up:** add the FlyMy.AI MCP to your assistant and sign in, save your Instantly API key once in FlyMy.AI, ask. - **Every action says what it does.** 133 only read. The rest are labelled as writes, sends, deletes or spends, your assistant is told to confirm changes with you, and a write is never sent twice on its own. - **Instantly also runs its own MCP server** at `mcp.instantly.ai`. The [comparison](https://flymy.ai/blog/instantly-mcp-guide/#compare) shows when to pick which. ## What is the Instantly MCP? [Instantly](https://instantly.ai) is a cold email platform: sending accounts with warmup, campaigns with multi-step sequences, leads and lead lists, Unibox with the replies of every account in one inbox, and SuperSearch to find new leads. All of it is also reachable through the Instantly API v2. The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open standard for connecting AI assistants to tools. An MCP server publishes tools; the assistant reads their descriptions and calls the one a task needs. An Instantly MCP server publishes the Instantly API as tools, so you can ask "which campaign got the most replies this week?" and the assistant makes the API calls and answers. There are two ways to get one: - **Instantly's hosted server** at `mcp.instantly.ai`. Instantly's docs say it exposes the full Instantly V2 API as tools generated from the API spec; you connect it with your Instantly API key. - **The Instantly MCP inside the FlyMy.AI MCP** at `https://mcp-agents.flymy.ai/mcp`: 268 Instantly actions next to 1,500+ other tools, 500+ AI models and agents that run in the cloud. Your Instantly key is saved once in your FlyMy.AI account. This guide sets up the second one and compares both [further down](https://flymy.ai/blog/instantly-mcp-guide/#compare). ## What's new: the whole Instantly API on FlyMy.AI Until this release the Instantly connector on FlyMy.AI had 27 actions for campaigns, leads, sending accounts and analytics. [Platform log 2.2.1](https://flymy.ai/changelog/#v2.2.1) adds every other operation of Instantly's public API reference, which we read again on release day, 13 November 2026: 268 operations in 37 groups, one action each. 268 actions, one per Instantly API operation 133 only read and are safe to repeat 135 change something: 81 writes, 9 sends, 32 deletes, 13 spends - **New areas.** Unibox, webhooks and their events, subsequences, the block list, inbox placement tests, SuperSearch and enrichment, workspace members and API keys, and Instantly's four kinds of AI agents. - **Every documented field is an argument.** Each action has a typed schema generated from the reference, nested objects, enums and limits included, and a request is checked against it before it is sent. - **Whole answers.** A CSV export or another text answer comes back in full; the old connector cut text at 2,000 characters. - **Long jobs are followed up.** An action that starts background work, such as a warmup change, the connection of a Google or Microsoft inbox or a local business conversion, names the read that tracks it. ## What your assistant can do in Instantly The 268 actions fall into seven families. The [Instantly MCP page](https://flymy.ai/mcp/instantly/) lists every action with its description, and the [Instantly docs page](https://docs.flymy.ai/mcp/instantly) covers the connection fields. | Family | Actions | What your assistant can do | |---|---|---| | Campaigns and subsequences | 30 | Create, update, activate, pause, duplicate, share and export campaigns; analytics totals, overview, daily and per step; why a campaign is not sending. | | Leads, lists, labels and the block list | 34 | Import up to 1,000 leads per call; search, update, move, merge and assign leads and set their interest status; lead lists and labels; the block list with a CSV download. | | Sending accounts | 30 | Add, update, pause and resume accounts; warmup on or off and its analytics; account vitals; connect Google or Microsoft inboxes; order done-for-you accounts. | | Unibox and deliverability | 26 | List, read, reply to and forward emails, count unread and mark threads read; verify an email address; inbox placement tests and their reports. | | Workspace, webhooks and tags | 46 | Workspace, plan, members and workspace group; API keys, audit log and background jobs; webhooks and their events; custom tags on accounts and campaigns. | | SuperSearch and lead sources | 39 | Count, preview and enrich SuperSearch leads; saved searches, company lists, creator search and local business search. | | Instantly AI agents | 63 | AI sales agents, inbox managers, lead finder agents and the deliverability agent: settings, activity, approvals and analytics. | ## How to connect Instantly MCP in three steps You need an Instantly workspace where you can create an API v2 key and an assistant that speaks MCP. A free FlyMy.AI account is enough to start; you can create it while you sign in. ### 1. Create an Instantly API key In Instantly, open [Settings, Integrations](https://app.instantly.ai/app/settings/integrations) and the **API Keys** section. Click **Create API Key**, give it a name such as FlyMy.AI, select its scopes and press **Create**. Copy the key right away: Instantly shows it only once. Scopes decide what the key may do. Instantly names the scopes of each operation on its reference page, such as `campaigns:read`, `leads:all` or `all:all`; an action outside the key's scopes answers 403. ### 2. Add FlyMy.AI to your assistant The FlyMy.AI MCP lives at one URL, `https://mcp-agents.flymy.ai/mcp`, and you sign in to it. There is no FlyMy.AI key to copy. - **Claude Code:** run `claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp`, then `/mcp` to sign in. - **Codex:** run `codex mcp add flymy --url https://mcp-agents.flymy.ai/mcp`, then `codex mcp login flymy`. - **claude.ai, Claude Desktop and ChatGPT:** Settings, Connectors, Add custom connector, then paste the URL and sign in. - **Cursor and other MCP clients:** add the same URL as a remote MCP server. ### 3. Save the key in FlyMy.AI Open the [Instantly connection settings](https://app.flymy.ai/mcp-configs#instantly), paste the key into **Instantly API key** and save. The key stays in your FlyMy.AI account, not in a prompt, a chat or your assistant's config. If you skip this step, your assistant gets the same link the first time it needs Instantly. ![Screenshot of step 2 on the Instantly MCP page on flymy.ai: Add your Instantly API key. Paste it into the Instantly connection settings once; it stays with FlyMy.AI, never in a prompt or a chat. The one field is Instantly API key, created at app.instantly.ai under Settings, Integrations, API Keys, with a link to open the Instantly API settings.](https://flymy.ai/blog/instantly-mcp-guide/img/mcp-page-instantly-connect.jpg) Step 2 on the [Instantly MCP page](https://flymy.ai/mcp/instantly/#connect): the one field FlyMy.AI asks for, with a link to Instantly's API settings. ### Check the connection Start with a request that only reads: Try it ``` Show my Instantly workspace name and list my sending accounts with their warmup status. ``` Your assistant finds the Instantly actions through FlyMy.AI's tool search and calls `instantly_workspace_current` and `instantly_accounts_list`. Prefer to let the assistant do the setup? Paste this into any assistant: Setup request ``` Read https://flymy.ai/skill.md and https://flymy.ai/mcp/instantly.md. Help me connect Instantly MCP to this assistant. Then help me run this task: Which of my Instantly campaigns got the most replies this week? Show sent, opens and replies for each. ``` ## Use cases with ready prompts Paste these into an assistant connected to FlyMy.AI and change the names to yours. Under each prompt are the actions it runs on. ### 1. See which campaigns get replies A weekly report with no export: sent, opened and replied for each campaign, from Instantly's campaign analytics. Try it ``` Which of my Instantly campaigns got the most replies in the last 7 days? Show sent, opens, replies and reply rate for each, best first. ``` Uses `instantly_campaigns_list` and `instantly_campaign_analytics`. ### 2. Sort Unibox replies and draft answers The assistant reads the unread replies, groups them, sets each lead's interest status and drafts answers that you approve one by one. Try it ``` Read my unread Instantly replies from the last 24 hours. Group them into interested, not now and not interested, set each lead's interest status, and draft an answer to every interested reply. Show me the drafts and send nothing until I approve each one. ``` Uses `instantly_emails_list`, `instantly_lead_interest_status_update` and, after your approval, `instantly_email_reply`. ### 3. Import leads from a sheet without duplicates Instantly's bulk import takes up to 1,000 leads per call, checks them against your block list and can skip anyone already in your workspace. With the [Google Sheets connector](https://flymy.ai/mcp/google-sheets/) the leads can come straight from a sheet. Try it ``` Add the leads from my Google Sheet 'Q4 prospects' to my Instantly campaign 'Founders Q4'. Skip anyone already in my workspace and tell me how many were uploaded, skipped, duplicated or on the block list. ``` Uses `instantly_campaigns_list` and `instantly_leads_add`, with Google Sheets for the rows. ### 4. Check deliverability before a launch Warmup health scores and account vitals for every sending account, in one answer. Try it ``` Check the warmup health and vitals of all my Instantly sending accounts and list the ones that need attention, worst first. ``` Uses `instantly_accounts_list`, `instantly_accounts_warmup_analytics` and `instantly_accounts_test_vitals`. ### 5. Send replies to your own system with a webhook Instantly can call your URL on events such as `reply_received`, `lead_interested` or `lead_meeting_booked`. Try it ``` Create an Instantly webhook that sends every reply_received event to https://example.com/hooks/instantly, then send it a test event. ``` Uses `instantly_webhook_create` and `instantly_webhook_test`. ### 6. Find new leads with SuperSearch, preview first SuperSearch filters by title, department, level, location, industry, employee count, technologies and more. Counting and previewing only read; enriching leads into a list spends Instantly credits, so ask for a preview first. Try it ``` Use Instantly SuperSearch to count heads of marketing at SaaS companies in Germany with 50 to 200 employees and show me a preview of ten. Do not enrich or import anyone until I approve. ``` Uses `instantly_supersearch_count_leads`, `instantly_supersearch_preview_leads` and, after your approval, `instantly_supersearch_enrich_leads`. ### 7. Leave an agent running in the cloud A FlyMy.AI project keeps working after you close the chat: on a schedule, with Instantly and any other connector, such as [Slack](https://flymy.ai/mcp/slack/) for the summary. Try it ``` Create a FlyMy.AI project that every weekday morning reads my new Instantly replies, marks the interested leads and sends me a short summary in Slack. ``` Uses a FlyMy.AI project with the Instantly and Slack connectors. ## What happens before it sends, deletes or spends An assistant in your Instantly workspace can do real things: send email, delete leads, spend credits. FlyMy.AI labels every action by what it does, whatever its HTTP method says, so a search sent as POST is still a read. | What it does | Actions | Examples | |---|---|---| | Reads | 133 | Analytics, lists, Unibox, SuperSearch counts and previews. 18 of them are searches or reports sent as POST. Safe to repeat. | | Writes | 81 | Create or update campaigns, import or move leads, pause accounts, set up webhooks. | | Sends | 9 | Activate a campaign or resume a subsequence, reply, forward, test emails and inbox placement tests, a webhook test, member invitations. | | Deletes | 32 | Campaigns, leads, lists, sending accounts, webhooks, API keys and more, for good. | | Spends | 13 | SuperSearch and AI enrichment, lead finder agents, creator search, local business conversion, company lists, done-for-you orders, email verification. | - **Your assistant is asked to confirm first.** The Instantly instructions FlyMy.AI gives your assistant say to confirm every change with you, and name the actions that send real email, delete for good or spend credits or money. - **A write goes out once.** When Instantly's answer is lost (a timeout or a 5xx), FlyMy.AI reports the outcome as unknown and does not send the call again. A write Instantly refused, such as a 400, 403, 422 or 429, did not happen, so a corrected call can go. - **Imports carry an idempotency key.** Every lead import goes with Instantly's `idempotency_key`: yours, or one FlyMy.AI derives from the call and records with it. Instantly answers a repeat with the same key and the same leads with the leads it already created instead of adding them again. - **A selection never widens.** An empty, `.` or `..` ID is refused before the call, because a URL would drop it and a single delete could turn into "delete all". A bulk delete, move or assign is never sent with an empty list of IDs. - **Keys stay masked.** Listing your Instantly API keys shows them masked; a new key is shown once, when it is created. ## Instantly's own MCP server or FlyMy.AI? Both give an assistant the Instantly API. They differ in where your key lives and in what else the assistant can reach. The table sticks to what each one documents; Instantly's MCP docs were read on 13 November 2026. | Question | FlyMy.AI MCP | Instantly MCP server | |---|---|---| | API coverage | 268 actions, one per operation of the API v2 reference, checked against it on 13 November 2026 | The full V2 API, with tools generated from the API spec | | Server URL | `https://mcp-agents.flymy.ai/mcp` | `https://mcp.instantly.ai/mcp` | | Your Instantly key | Saved once in your FlyMy.AI account; the assistant signs in to FlyMy.AI | In the client: the `Authorization` or `x-instantly-api-key` header, or in the URL path, which their Claude Desktop and Cursor setup uses | | Other tools on the same server | 1,500+ tools such as [HubSpot](https://flymy.ai/mcp/hubspot/), Google Sheets, Slack and [Gmail](https://flymy.ai/mcp/gmail/), web search and 500+ AI models | Instantly | | Work on a schedule | FlyMy.AI projects run agents in the cloud on a schedule | Your MCP client makes the calls when you ask | | Tool names | `instantly_campaigns_list`, `instantly_campaign_analytics` | `list_campaigns`, `get_campaign_analytics` | Sources: Instantly MCP docs, [introduction](https://developer.instantly.ai/mcp/introduction), [quickstart](https://developer.instantly.ai/mcp/quickstart), [authentication](https://developer.instantly.ai/mcp/authentication) and [available tools](https://developer.instantly.ai/mcp/tools), read on 13 November 2026. Pick Instantly's server if Instantly is the only tool your assistant needs and you are fine keeping the key in the client's config. Pick FlyMy.AI when the work spans tools - leads from a sheet or a CRM, research on the web, a summary in Slack - when the key should stay out of client configs, or when an agent should keep working on a schedule. ## What it costs Calls go to your own Instantly account, under its plan and limits: sending volume, SuperSearch and enrichment credits, done-for-you accounts. FlyMy.AI meters each tool call by the seconds it runs, at $0.000037 per second of tool time, with no seats and no minimum; an agent that runs on FlyMy.AI also pays for its model. In our production check on 13 November 2026, `instantly_workspace_current` answered in 529 ms, about $0.00002 of tool time. Every run shows what it cost; see [pricing](https://flymy.ai/pricing/). ## Limits and troubleshooting ### 401: the key is wrong or was deleted Create a new key in Instantly and paste it into the [Instantly connection settings](https://app.flymy.ai/mcp-configs#instantly) again. ### 403: the key lacks a scope The key's scopes do not cover that operation. Create a key with the scopes your workflow needs; Instantly lists them on each reference page. ### 429: too many requests Instantly allows 100 requests per second and 6,000 per minute per workspace, shared by API v1 and v2 and by every key. FlyMy.AI keeps Instantly's `Retry-After` with the error, so the assistant knows how long to wait; spread large jobs over the day. ### Moving accounts to another workspace fails Instantly allows it only with the API key of the admin workspace of a workspace group. ### Tagging a workspace is refused Instantly accepts workspace tags only from a signed-in user, not from an API key. Tags on accounts and campaigns work with a key. ### No switch for workspace-wide open tracking "Disable open tracking" and "Always send first email as text-only" have no public API endpoint. Set `open_tracking` and `first_email_text_only` on each campaign instead. ## FAQ **Is there an Instantly MCP?** Yes. Instantly runs a hosted MCP server at mcp.instantly.ai, and the FlyMy.AI MCP includes Instantly with 268 actions, one for every operation of the Instantly API v2 reference, next to 1,500+ other tools. Both connect with your Instantly API key. **What does MCP stand for?** Model Context Protocol. It is an open standard, introduced by Anthropic in November 2024, for connecting AI assistants to tools and data. Claude, ChatGPT, Cursor and Codex can all use MCP servers. **Does Instantly have an API?** Yes. The Instantly API v2 is a REST API at api.instantly.ai/api/v2 that takes an API key as a Bearer token. Its public reference lists 268 operations in 37 groups. The rate limit is 100 requests per second and 6,000 per minute per workspace. **Where do I find my Instantly API key?** In Instantly, open Settings, Integrations and the API Keys section (app.instantly.ai/app/settings/integrations), click Create API Key, name it, select its scopes and press Create. Copy the key right away: Instantly shows it only once and cannot recover it. **Instantly API or Instantly MCP: which do I need?** The API is for code you write. The MCP lets an AI assistant call the same API from a request in plain words, with no code. Both use the same Instantly API key, so you can start with the MCP and script the parts you repeat. **Can I use Instantly with ChatGPT?** Yes. Add the FlyMy.AI MCP to ChatGPT as a custom connector (Settings, Connectors, Add custom connector, https://mcp-agents.flymy.ai/mcp), sign in, and save your Instantly API key once in FlyMy.AI. The same steps work in claude.ai and Claude Desktop. **Can Claude send emails through Instantly?** Yes. With the Instantly MCP, Claude can reply to and forward Unibox emails, send test emails and activate campaigns. These actions send real email, and the Instantly instructions FlyMy.AI gives Claude say to confirm with you before any change. **Is there an AI for cold email?** Instantly has its own AI agents for sales replies, inbox management, lead finding and deliverability, and its API exposes all four (63 actions on FlyMy.AI). With an MCP, a general assistant such as Claude or ChatGPT can also read your replies, draft answers and report on your campaigns. **What is a simple AI agent?** A model that uses tools in a loop to finish a task: it reads what it needs, calls a tool, checks the result and decides the next step. Claude with the Instantly MCP that reads yesterday's replies and drafts answers is a simple AI agent; a FlyMy.AI project can run one on a schedule. **How much does the Instantly MCP cost on FlyMy.AI?** Creating a FlyMy.AI account is free. A tool call is metered by the seconds it runs, at $0.000037 per second, with no seats and no minimum; a read of half a second costs about $0.00002. Instantly's own usage stays under your Instantly plan. ## Give your assistant the whole Instantly API 268 actions on one MCP server, your key saved once, and 1,500+ other tools beside them. [Open the Instantly MCP page](https://flymy.ai/mcp/instantly/) [Read the platform log](https://flymy.ai/changelog/#v2.2.1) ## Keep reading - [Instantly MCP: all 268 actions Every action with its description and the setup.](https://flymy.ai/mcp/instantly/) - [One MCP, 1,500+ tools Every connector and model, with setup commands.](https://flymy.ai/mcp/) - [How to build an AI agent with Claude Every agent lives in a project.](https://flymy.ai/blog/how-to-build-an-ai-agent-with-claude/) - [Hermes Agent MCP guide Give Hermes 1,500+ tools with one server.](https://flymy.ai/blog/hermes-agent-mcp/) - [Platform log What is new on FlyMy.AI, release by release.](https://flymy.ai/changelog/) - [Instantly in the docs Credentials, fields and troubleshooting.](https://docs.flymy.ai/mcp/instantly) --- For agents: the FlyMyAI operating guide (sign up, connect, run models, tools and agents) is https://flymy.ai/skill.md, and https://flymy.ai/llms.txt lists the other pages and the documentation.