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.

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.

What is the Instantly MCP?

Instantly 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 (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.

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 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 lists every action with its description, and the Instantly docs page covers the connection fields.

FamilyActionsWhat your assistant can do
Campaigns and subsequences30Create, 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 list34Import 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 accounts30Add, 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 deliverability26List, 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 tags46Workspace, 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 sources39Count, preview and enrich SuperSearch leads; saved searches, company lists, creator search and local business search.
Instantly AI agents63AI 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 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, 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.
Step 2 on the Instantly MCP page: 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 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 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 doesActionsExamples
Reads133Analytics, lists, Unibox, SuperSearch counts and previews. 18 of them are searches or reports sent as POST. Safe to repeat.
Writes81Create or update campaigns, import or move leads, pause accounts, set up webhooks.
Sends9Activate a campaign or resume a subsequence, reply, forward, test emails and inbox placement tests, a webhook test, member invitations.
Deletes32Campaigns, leads, lists, sending accounts, webhooks, API keys and more, for good.
Spends13SuperSearch 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.

QuestionFlyMy.AI MCPInstantly MCP server
API coverage268 actions, one per operation of the API v2 reference, checked against it on 13 November 2026The full V2 API, with tools generated from the API spec
Server URLhttps://mcp-agents.flymy.ai/mcphttps://mcp.instantly.ai/mcp
Your Instantly keySaved once in your FlyMy.AI account; the assistant signs in to FlyMy.AIIn 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 server1,500+ tools such as HubSpot, Google Sheets, Slack and Gmail, web search and 500+ AI modelsInstantly
Work on a scheduleFlyMy.AI projects run agents in the cloud on a scheduleYour MCP client makes the calls when you ask
Tool namesinstantly_campaigns_list, instantly_campaign_analyticslist_campaigns, get_campaign_analytics

Sources: Instantly MCP docs, introduction, quickstart, authentication and available 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.

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 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.

Keep reading