Summary

Load the categories you need — 38 tools is a lot of context to carry.

`TOOL_CATEGORIES` is the setting to reach for first: most sessions want two categories, not six, and the difference is 14 tool definitions against 38 riding along every turn. Note also which tools act on the outside world — `reply_to_email` sends a real email, and the delete tools on accounts, campaigns, leads and lead lists are permanent — so decide up front whether this installation is for reading analytics or for running the sending.

What it is

A FastMCP server over the Instantly.ai V2 API, covering 38 tools across six categories: accounts, campaigns, leads, emails, analytics and background jobs. It runs locally over stdio or as a remote HTTP deployment, and in HTTP mode it can take a different API key per request so one deployment can serve several tenants.

What you get

Sending accounts listed, created with IMAP/SMTP credentials, updated, paused, resumed, warmup-controlled and vitals-tested — `list_accounts`, `get_account`, `create_account`, `update_account`, `manage_account_state`, `delete_account`
Campaigns created, listed, read with their sequences, updated, started and stopped, plus a lookup for which campaigns a given contact is enrolled in — `create_campaign`, `list_campaigns`, `get_campaign`, `activate_campaign`, `pause_campaign`, `search_campaigns_by_contact`
Leads and lead lists managed, with up to 1,000 leads added in one bulk call, leads moved or copied between campaigns and lists, and email verification stats per list — `list_leads`, `create_lead`, `update_lead`, `create_lead_list`, `add_leads_to_campaign_or_list_bulk`, `move_leads_to_campaign_or_list`, `get_verification_stats_for_lead_list`
The inbox worked from the same place: emails listed and read, unread counted, a thread marked read, an address checked for deliverability, and a real reply sent — `list_emails`, `get_email`, `count_unread_emails`, `mark_thread_as_read`, `verify_email`, `reply_to_email`
Campaign performance as totals and day by day, plus warmup metrics per account — `get_campaign_analytics`, `get_daily_campaign_analytics`, `get_warmup_analytics`
Long-running work tracked rather than guessed at: async jobs listed and inspected — `list_background_jobs`, `get_background_job`
Your current rate-limit position, tracked from Instantly's response headers — `get_server_info`

Requirements

An Instantly.ai API key from your account's integrations settings. Locally it goes in `INSTANTLY_API_KEY`; over HTTP it can travel in the URL path, in an `Authorization` header, or in an `x-instantly-api-key` header, which is what makes per-tenant keys possible. The package is `instantly-mcp` on PyPI (1.0.1 in pyproject), installed with `pip install -e .` and run over stdio or with `--transport http`. `TOOL_CATEGORIES` narrows which categories load — setting it to `accounts,campaigns` gives 14 tools instead of 38.