# Instantly — how to use (mcp.ai)

Connect your Instantly account and use 117 tools for drip emails straight from your AI agent. Connect with your own API key. Instantly is a platform designed to streamline cold email outreach by automating campaigns, managing leads, and enhancing email deliverability.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_instantly?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `instantly_accounts_ctd_status_get`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/instantly`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/instantly/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/instantly/accounts/ctd/status/get` — Tool to check Custom Tracking Domain (CTD) status for email accounts. Use to verify SSL configuration and CNAME records for a specified domain/host.
  - body: { host: string }
- `POST https://api.mcp.ai/api/instantly/activate/campaign` — Tool to activate or resume a paused campaign. Use when you need to start sending operations for a specific campaign. Prerequisites: Campaign must have at least one sender account, one lead, email sequ
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/add/leads/bulk` — Tool to add multiple leads in bulk to a campaign or list. Use when you need to import several leads at once to an Instantly campaign or list. Supports duplicate handling options and lead verification.
  - body: { leads: object[], verify?: boolean, list_id?: string, campaign_id?: string, blocklist_id?: string, skip_if_in_list?: boolean, verify_leadfinder?: boolean, skip_if_in_campaign?: boolean, skip_if_in_workspace?: boolean }
- `POST https://api.mcp.ai/api/instantly/api/keys/get` — Tool to retrieve paginated list of API keys for organization. Use when you need to list all API keys with their names, scopes, and timestamps.
  - body: { limit?: integer, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/bulk/assign/leads` — Tool to bulk assign leads to organization users. Use when you need to assign multiple leads to specific organization members.
  - body: { lead_ids: string[], organization_user_ids: string[] }
- `POST https://api.mcp.ai/api/instantly/campaigns/analytics/overview/get` — Tool to get analytics overview for one or multiple campaigns. Use when you need comprehensive performance metrics including leads, emails, replies, opens, clicks, and CRM events.
  - body: { id?: string, ids?: string[], end_date?: string, start_date?: string, campaign_status?: integer, expand_crm_events?: boolean }
- `POST https://api.mcp.ai/api/instantly/campaigns/from/export/post` — Tool to import a campaign from exported data. Use when you need to recreate a campaign from previously exported configuration.
  - body: { id: string, name: string, status: integer, campaign_id: string, organization: string, campaign_schedule: object, timestamp_created: string, timestamp_updated: string }
- `POST https://api.mcp.ai/api/instantly/check/dfy/email/account/order/domains` — Tool to check domain availability for DFY email account orders. Use when you need to validate domains before creating DFY email account orders.
  - body: { domains: string[] }
- `POST https://api.mcp.ai/api/instantly/check/email/verification/status` — Tool to check status of an email verification job. Use after submitting a verification request to retrieve the current status of a specific email address.
  - body: { email: string }
- `POST https://api.mcp.ai/api/instantly/count/launched/campaigns` — Tool to retrieve the count of launched campaigns. Use when you need to know the total number of campaigns that have been launched in the workspace.
- `POST https://api.mcp.ai/api/instantly/count/leads/from/supersearch` — Tool to count leads matching supersearch filter criteria. Use when you need to preview how many leads match your search criteria before creating an enrichment job.
  - body: { limit?: integer, search_filters: object, skip_already_owned?: boolean }
- `POST https://api.mcp.ai/api/instantly/count/unread/emails` — Tool to retrieve the count of unread emails. Use when you need to know how many unread messages are in your inbox before sending new emails.
- `POST https://api.mcp.ai/api/instantly/create/ai/enrichment` — Tool to create an AI enrichment job for a campaign or lead list. Use when you need to enrich a resource with AI-driven insights.
  - body: { limit?: integer, prompt?: string, status?: integer, overwrite?: boolean, show_state?: boolean, auto_update?: boolean, resource_id: string, template_id?: integer, input_columns?: string[], model_version: string, output_column: string, resource_type: integer, use_instantly_account?: boolean, skip_leads_without_email?: boolean }
- `POST https://api.mcp.ai/api/instantly/create/api/key` — Creates a new API key with specified permissions for the Instantly API. Use this tool to generate credentials for programmatic access. Each API key can be scoped with granular permissions (e.g., 'camp
  - body: { name: string, scopes: string[] }
- `POST https://api.mcp.ai/api/instantly/create/block/list/entry` — Tool to create a new block list entry for a specific email or domain. Use when you need to prevent campaigns from sending emails to a specific address or domain.
  - body: { bl_value: string }
- `POST https://api.mcp.ai/api/instantly/create/campaign` — Tool to create a new campaign. Use when you have campaign details ready and want to launch.
  - body: { name: string, cc_list?: string[], bcc_list?: string[], owned_by?: string, pl_value?: number, email_gap?: number, sequences?: object[], text_only?: boolean, email_list?: string[], daily_limit?: integer, is_evergreen?: boolean, link_tracking?: boolean, open_tracking?: boolean, stop_on_reply?: boolean, email_tag_list?: string[], match_lead_esp?: boolean, daily_max_leads?: integer, random_wait_max?: number, stop_for_company?: boolean, campaign_schedule: object, stop_on_auto_reply?: boolean, auto_variant_select?: object, allow_risky_contacts?: boolean, prioritize_new_leads?: boolean, first_email_text_only?: boolean, disable_bounce_protect?: boolean, provider_routing_rules?: object[], insert_unsubscribe_header?: boolean }
- `POST https://api.mcp.ai/api/instantly/create/custom/tag` — Tool to create a new custom tag for organizing accounts and campaigns. Use when you need to create a new tag for categorization purposes.
  - body: { label: string, description?: string }
- `POST https://api.mcp.ai/api/instantly/create/inbox/placement/test` — Tool to create an inbox placement test. Use when you need to measure deliverability across providers with your prepared email and recipient list.
  - body: { name: string, tags?: string[], type: integer, emails: string[], status?: integer, schedule?: object, test_code?: string, text_only?: boolean, email_body: string, automations?: object[], campaign_id?: string, description?: string, delivery_mode?: integer, email_subject: string, sending_method: integer, run_immediately?: boolean, recipients_labels?: object[], not_sending_status?: string, timestamp_next_run?: string }
- `POST https://api.mcp.ai/api/instantly/create/lead` — Tool to create a new lead. Use when you need to add an individual lead to a campaign.
  - body: { email?: string, phone?: string, website?: string, campaign?: string, last_name?: string, first_name?: string, company_name?: string, personalization?: string, custom_variables?: object, lt_interest_status?: integer }
- `POST https://api.mcp.ai/api/instantly/create/lead/list` — Tool to create a new lead list. Use when you need to organize leads into a dedicated list before importing them into campaigns.
  - body: { name: string, owned_by?: string, has_enrichment_task?: boolean }
- `POST https://api.mcp.ai/api/instantly/create/subsequence` — Creates an automated follow-up subsequence for a campaign. Subsequences are triggered when leads meet specific conditions (CRM status changes, activities, or reply keywords). Use this tool when you ne
  - body: { name: string, sequences: object[], conditions: object, parent_campaign: string, subsequence_schedule: object }
- `POST https://api.mcp.ai/api/instantly/create/supersearch/enrichment` — Tool to create a supersearch enrichment job for a list or campaign. Use when you need to enrich leads with data such as email verification, work email, profile information, job listings, technologies,
  - body: { type: string, limit?: integer, lead_ids?: string[], auto_update?: boolean, resource_id: string, input_columns?: string[], model_version?: string, enrichment_payload?: object, overwrite_existing?: boolean, use_instantly_credits?: boolean, skip_leads_without_email?: boolean }
- `POST https://api.mcp.ai/api/instantly/create/webhook` — Tool to create a new webhook endpoint. Use when you need to receive Instantly event notifications via HTTP callbacks.
  - body: { campaign?: string, event_type?: string, target_hook_url: string, custom_interest_value?: integer }
- `POST https://api.mcp.ai/api/instantly/delete/api/key` — Tool to delete an API key. Use when you need to remove a specific API key by its ID after confirming its existence.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/block/list/entry` — Tool to delete a blocked email or domain entry by its ID. Use when you need to remove a specific block list entry.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/campaign` — Tool to delete a campaign. Use when you need to remove a specific campaign by ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/custom/tag` — Tool to delete a custom tag by its ID. Use when you need to remove a specific custom tag used for organizing and categorizing accounts and campaigns.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/lead` — Tool to delete a lead by its ID. Use when you need to remove a specific lead after confirming its existence.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/lead/label` — Tool to delete a lead label by ID. Use when you need to remove a custom label for categorizing and managing leads.
  - body: { id: string, reassigned_status?: integer }
- `POST https://api.mcp.ai/api/instantly/delete/lead/list` — Tool to delete a lead list by ID. Use when you need to remove a specific lead list after confirming its existence.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/subsequence` — Delete a subsequence from a campaign by its UUID. A subsequence is an automated follow-up sequence triggered by specific conditions (e.g., CRM status changes, lead activity, or reply content). Use thi
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/webhook` — Tool to delete a webhook. Use when you need to remove a specific webhook by its UUID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/delete/whitelabel/domain` — Tool to delete the whitelabel domain from current workspace. Use when you need to remove the whitelabel domain configuration from a workspace.
- `POST https://api.mcp.ai/api/instantly/dfy/email/account/orders/domains/pre/warmed/up` — Tool to retrieve a list of pre-warmed up domains ready for DFY email account orders. Use when you need to check available domains that come pre-configured with SPF, DKIM, DMARC, and warmup already com
  - body: { search?: string, domain_extensions?: string[] }
- `POST https://api.mcp.ai/api/instantly/disable/account/warmup` — Tool to disable the warm-up process for email accounts. Use when you need to stop warmup for specific or all accounts before sending critical campaigns.
  - body: { emails?: string[], excluded_emails?: string[], include_all_emails?: boolean }
- `POST https://api.mcp.ai/api/instantly/duplicate/campaign` — Tool to duplicate an existing campaign. Use when you need to create a copy of a campaign with the same configuration.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/duplicate/subsequence` — Tool to duplicate an existing subsequence to a specified parent campaign. Use when you need to create a copy of a subsequence with the same trigger conditions.
  - body: { id: string, name: string, parent_campaign: string }
- `POST https://api.mcp.ai/api/instantly/enable/account/warmup` — Tool to enable the warm-up process for email accounts. Use when you want to start warming up one or more accounts to improve deliverability.
  - body: { emails?: string[], excluded_emails?: string[], include_all_emails?: boolean }
- `POST https://api.mcp.ai/api/instantly/export/campaign` — Tool to export campaign data to JSON format. Use when you need to retrieve complete campaign configuration for backup or migration.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/account/campaign/mappings` — Tool to retrieve campaigns associated with an email account. Use when you need to find which campaigns are mapped to a specific email address.
  - body: { email: string, limit?: integer, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/get/accounts/analytics/daily` — Tool to retrieve daily account analytics showing emails sent per day for each account. Use when you need per-day performance metrics for email accounts.
  - body: { emails?: string[], end_date?: string, start_date?: string }
- `POST https://api.mcp.ai/api/instantly/get/accounts/warmup/analytics` — Tool to retrieve warmup analytics for specified email accounts. Use when you need daily and aggregate warmup statistics including health scores.
  - body: { emails: string[] }
- `POST https://api.mcp.ai/api/instantly/get/audit/logs` — Tool to retrieve audit log records for tracking system activities. Use when you need to review account activity history or monitor changes.
  - body: { limit?: integer, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/get/block/list/entry` — Tool to retrieve a specific blocked email or domain entry by its ID. Use when you have a block list entry UUID and need to check block details.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/campaign` — Tool to retrieve campaign details. Use when you need full campaign configuration for a given campaign ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/campaign/analytics` — Tool to retrieve analytics for campaigns. Use when you need performance metrics for one or multiple campaigns.
  - body: { id?: string, ids?: string[], end_date?: string, start_date?: string, exclude_total_leads_count?: boolean }
- `POST https://api.mcp.ai/api/instantly/get/campaign/sending/status` — Tool to retrieve campaign sending status diagnostics explaining why a campaign may not be sending emails or is sending slower than expected. Use when troubleshooting campaign delivery issues or unders
  - body: { id: string, with_ai_summary?: boolean }
- `POST https://api.mcp.ai/api/instantly/get/campaign/steps/analytics` — Tool to retrieve analytics data broken down by campaign steps and variants. Use when you need detailed performance metrics for each step in a campaign sequence.
  - body: { end_date: string, start_date: string, campaign_id?: string, include_opportunities_count?: boolean }
- `POST https://api.mcp.ai/api/instantly/get/current/workspace` — Tool to retrieve current workspace details based on API key. Use when you need workspace information like plan details, owner, or organization settings.
- `POST https://api.mcp.ai/api/instantly/get/custom/tag` — Tool to retrieve a specific custom tag by ID. Use when you need details about a custom tag used for organizing accounts and campaigns.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/custom/tag/mappings` — Tool to retrieve custom tag mappings that connect tags to resources like campaigns and email accounts. Use when you need to see which tags are assigned to which resources.
  - body: { limit?: integer, tag_ids?: string, resource_ids?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/get/daily/campaign/analytics` — Tool to retrieve daily analytics for a campaign. Use when you need per-day performance metrics for campaigns.
  - body: { end_date?: string, start_date?: string, campaign_id?: string, campaign_status?: integer }
- `POST https://api.mcp.ai/api/instantly/get/dfy/email/account/order/accounts` — Tool to retrieve DFY (Done-For-You) email account order accounts. Use when you need to fetch accounts from DFY email account orders with optional pagination and password inclusion.
  - body: { limit?: integer, starting_after?: string, with_passwords?: boolean }
- `POST https://api.mcp.ai/api/instantly/get/email/service/provider/options` — Tool to retrieve email service provider options for inbox placement tests. Use when you need valid recipients_labels options.
- `POST https://api.mcp.ai/api/instantly/get/inbox/placement/analytics/stats/by/date` — Tool to retrieve time-series statistics for inbox placement test results by date. Use when you need daily analytics showing how emails were distributed across inbox, spam, and category folders.
  - body: { test_id: string }
- `POST https://api.mcp.ai/api/instantly/get/inbox/placement/test` — Tool to retrieve inbox placement test results. Use when you need details for a specific inbox placement test by ID.
  - body: { id: string, with_metadata?: boolean }
- `POST https://api.mcp.ai/api/instantly/get/lead` — Tool to retrieve details of a specific lead by its ID. Use when you have the lead UUID and need full lead metadata.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/lead/label` — Tool to retrieve a specific lead label by ID. Use when you need details about a custom label for categorizing and managing leads.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/lead/labels` — DEPRECATED: Use INSTANTLY_GET_LEAD_LABEL instead. Tool to retrieve a specific lead label by ID. Use when you need details about a custom label for categorizing and managing leads.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/lead/list` — Tool to retrieve details of a specific lead list by its ID. Use when you have the lead list UUID and need list metadata.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/phone/numbers` — Tool to retrieve all phone numbers associated with your organization. Use when you need to list phone numbers configured for CRM actions.
- `POST https://api.mcp.ai/api/instantly/get/similar/dfy/email/account/order/domains` — Tool to generate similar available domain suggestions for DFY email account orders. Use when you need to find available domain alternatives based on a provided domain. Returns maximum of 66 suggestion
  - body: { domain: string, extensions?: string[] }
- `POST https://api.mcp.ai/api/instantly/get/subsequence` — Tool to retrieve a specific subsequence by its ID. Use when you need full details of a follow-up sequence entity.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/supersearch/enrichment` — Tool to retrieve supersearch enrichment configuration and status for a list or campaign. Use this to check enrichment settings, progress status, and configuration details for a specific list or campai
  - body: { resource_id: string }
- `POST https://api.mcp.ai/api/instantly/get/verification/stats/for/lead/list` — Tool to retrieve verification statistics for a lead list. Use when you need summary counts by verification status for a specific lead list.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/webhook` — Tool to retrieve details of a specific webhook subscription. Use when you have the webhook ID and need full webhook configuration.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/webhook/event` — Tool to retrieve details of a specific webhook event. Use when you need to inspect a particular webhook event by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/get/webhook/event/types` — Tool to retrieve all available webhook event types. Use when you need to see valid event types for webhook subscriptions.
- `POST https://api.mcp.ai/api/instantly/get/webhook/events/summary` — Tool to retrieve webhook events summary with success and failure statistics. Use when you need aggregated webhook delivery metrics for a date range.
  - body: { to_date: string, from_date: string }
- `POST https://api.mcp.ai/api/instantly/get/webhook/events/summary/by/date` — Tool to retrieve webhook event summaries grouped by date. Use when you need aggregated webhook event statistics over a date range.
  - body: { to_date: string, from_date: string }
- `POST https://api.mcp.ai/api/instantly/get/workspace/billing/plan/details` — Tool to retrieve workspace billing plan details. Use when you need to view billing plan information for various services like lead finder, verification, CRM, website visitor tracking, and inbox placem
- `POST https://api.mcp.ai/api/instantly/inbox/placement/analytics/deliverability/insights` — Tool to retrieve deliverability insights for inbox placement tests. Use when you need detailed percentage breakdowns of emails landing in spam, inbox, and category folders with optional date range fil
  - body: { date_to?: string, test_id: string, date_from?: string, recipient_esp?: integer[], recipient_geo?: integer[], show_previous?: boolean, recipient_type?: integer[], previous_date_to?: string, previous_date_from?: string }
- `POST https://api.mcp.ai/api/instantly/inbox/placement/analytics/stats/by/test/id` — Tool to retrieve aggregated inbox placement analytics statistics for specified test IDs. Use when you need consolidated inbox, spam, and category counts across multiple tests with optional filtering b
  - body: { date_to?: string, test_ids: string[], date_from?: string, sender_email?: string, recipient_esp?: integer[], recipient_geo?: integer[], recipient_type?: integer[] }
- `POST https://api.mcp.ai/api/instantly/lead/labels/post` — Tool to create a custom lead label for categorizing leads. Use when you need to create a new label to organize and manage leads with specific interest status categories.
  - body: { label: string, description?: string, use_with_ai?: boolean, interest_status_label: string }
- `POST https://api.mcp.ai/api/instantly/list/accounts` — Tool to list all email accounts for the authenticated user. Use after obtaining auth credentials to retrieve available accounts.
  - body: { limit?: integer, search?: string, status?: integer, tag_ids?: string, provider_code?: integer, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/api/keys` — DEPRECATED: Use INSTANTLY_INSTANTLY_API_KEYS_GET instead. Tool to list all API keys. Use when you need to retrieve your API keys with optional pagination after authentication.
  - body: { limit?: integer, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/block/list/entries` — Tool to list blocked emails or domains from blocklist. Use when you need to retrieve multiple block list entries with optional filtering by domains only or search terms. Supports pagination.
  - body: { limit?: integer, search?: string, domains_only?: boolean, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/campaigns` — Tool to list all campaigns. Use when you need to fetch your campaigns list with optional filters and pagination.
  - body: { limit?: integer, search?: string, tag_ids?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/custom/tags` — Tool to list custom tags. Use when you need to retrieve custom tags with optional pagination and filtering.
  - body: { limit?: integer, search?: string, tag_ids?: string, resource_ids?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/dfy/email/account/orders` — Tool to list DFY email account orders. Use when you need to fetch your DFY email account orders with pagination.
  - body: { limit?: integer, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/emails` — Tool to list emails. Use when you need to retrieve emails with optional filters and pagination.
  - body: { lead?: string, mode?: string, limit?: integer, search?: string, eaccount?: string, i_status?: integer, is_unread?: boolean, email_type?: string, sort_order?: string, assigned_to?: string, campaign_id?: string, has_reminder?: boolean, preview_only?: boolean, company_domain?: string, marked_as_done?: boolean, scheduled_only?: boolean, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/inbox/placement/blacklist/spam/assassin` — Tool to list inbox placement blacklist & SpamAssassin reports. Use when you need to retrieve spam and blacklist analytics after running an inbox placement test.
  - body: { limit?: integer, date_to?: string, test_id: string, date_from?: string, starting_after?: string, skip_blacklist_report?: boolean, skip_spam_assassin_report?: boolean }
- `POST https://api.mcp.ai/api/instantly/list/inbox/placement/tests` — Tool to list inbox placement tests. Use when you need a paginated overview of tests with optional filtering and sort order.
  - body: { limit?: integer, search?: string, status?: integer, sort_order?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/lead/lists` — Tool to list all lead lists. Use when you need to fetch the lead lists with optional filters and pagination.
  - body: { limit?: integer, search?: string, starting_after?: string, has_enrichment_task?: boolean }
- `POST https://api.mcp.ai/api/instantly/list/leads` — Tool to list leads. Use when you need to retrieve leads with optional filters like search, status filters, and pagination.
  - body: { ids?: string[], limit?: integer, filter?: string, search?: string, in_list?: boolean, list_id?: string, queries?: object[], campaign?: string, contacts?: string[], in_campaign?: boolean, excluded_ids?: string[], starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/webhook/events` — Tool to list webhook events. Use when you need to view received webhook events with optional pagination and filters.
  - body: { limit?: integer, search?: string, success?: boolean, to_date?: string, from_date?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/list/webhooks` — Tool to list configured webhooks. Use when you need to retrieve your webhook configurations with optional filters and pagination.
  - body: { limit?: integer, campaign?: string, event_type?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/instantly/mark/thread/as/read` — Tool to mark all emails in a specific thread as read. Use when you want to update the read status of an email thread after processing.
  - body: { thread_id: string }
- `POST https://api.mcp.ai/api/instantly/merge/leads` — Tool to merge multiple leads into a single lead. Use after confirming both source and destination lead IDs exist.
  - body: { lead_id: string, destination_lead_id: string }
- `POST https://api.mcp.ai/api/instantly/move/leads` — Tool to move leads from one campaign to another. Use when you need to transfer specific leads between campaigns.
  - body: { ids: string[], campaign: string, to_campaign_id: string }
- `POST https://api.mcp.ai/api/instantly/patch/lead/label` — Tool to update an existing lead label by ID. Use when you need to modify a custom label for categorizing and managing leads.
  - body: { id: string, label?: string, description?: string, use_with_ai?: boolean, interest_status_label?: string }
- `POST https://api.mcp.ai/api/instantly/patch/supersearch/enrichment/settings` — Tool to update auto-update and skip settings for SuperSearch enrichment. Use when you need to configure enrichment behavior for leads in a list or campaign, including automatic enrichment of new leads
  - body: { overwrite?: boolean, auto_update?: boolean, resource_id: string, is_evergreen?: boolean, skip_rows_without_email?: boolean }
- `POST https://api.mcp.ai/api/instantly/patch/webhook` — Tool to update an existing webhook configuration. Use when you need to modify webhook properties like name, event type, or target URL.
  - body: { id: string, name?: string, headers?: object, campaign?: string, event_type?: string, target_hook_url?: string, custom_interest_value?: integer }
- `POST https://api.mcp.ai/api/instantly/pause/campaign` — Tool to pause an active campaign. Use when you need to suspend sending operations for a specific campaign.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/pause/subsequence` — Tool to pause an active campaign subsequence. Use when you need to temporarily suspend a follow-up sequence.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/remove/lead/from/subsequence` — Tool to remove a lead from a campaign subsequence. Use when you need to stop a lead from receiving subsequence emails.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/resume/subsequence` — Tool to resume a paused campaign subsequence. Use when you need to restart a previously paused follow-up sequence.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/search/campaigns/by/lead/email` — Tool to search campaigns by a lead's email address. Use when you need to find campaigns containing a specific lead by their email.
  - body: { search: string, sort_order?: string, sort_column?: string }
- `POST https://api.mcp.ai/api/instantly/set/whitelabel/domain` — Tool to set whitelabel agency domain for current workspace. Use when you need to configure custom branding with your own domain name for the workspace.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/instantly/share/campaign` — Tool to share a campaign. Use when you need to share a campaign template for 7 days.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/supersearch/enrichment/run/post` — Tool to run all enrichments for resource leads or unenriched leads. Use when you need to trigger enrichment processes for a list or campaign.
  - body: { resource_id: string }
- `POST https://api.mcp.ai/api/instantly/test/accounts/vitals` — Tool to test IMAP/SMTP connectivity and account vitals for email accounts. Use when you need to verify email account health and connectivity status.
  - body: { accounts: string[] }
- `POST https://api.mcp.ai/api/instantly/test/webhook` — Tool to send a test payload to verify a webhook is working. Use when you need to verify a webhook configuration.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/toggle/resource` — Tool to assign or unassign custom tags to resources like accounts and campaigns. Use when you need to manage custom tag associations with resources by either assigning or unassigning tags.
  - body: { assign: boolean, filter?: object, tag_ids: string[], resource_ids: string[], selected_all?: boolean, resource_type: integer }
- `POST https://api.mcp.ai/api/instantly/update/block/list/entry` — Tool to update a blocked email or domain entry. Use when you need to modify the bl_value of an existing block list entry.
  - body: { id: string, bl_value: string }
- `POST https://api.mcp.ai/api/instantly/update/campaign` — Tool to update details of a campaign. Use when you need to modify campaign settings after verifying its ID.
  - body: { id: string, name?: string, cc_list?: string[], bcc_list?: string[], owned_by?: string, pl_value?: number, email_gap?: integer, sequences?: object[], text_only?: boolean, email_list?: string[], daily_limit?: integer, is_evergreen?: boolean, link_tracking?: boolean, open_tracking?: boolean, stop_on_reply?: boolean, email_tag_list?: string[], match_lead_esp?: boolean, daily_max_leads?: integer, random_wait_max?: integer, stop_for_company?: boolean, campaign_schedule?: object, stop_on_auto_reply?: boolean, auto_variant_select?: object, allow_risky_contacts?: boolean, prioritize_new_leads?: boolean, first_email_text_only?: boolean, disable_bounce_protect?: boolean, provider_routing_rules?: object[], insert_unsubscribe_header?: boolean }
- `POST https://api.mcp.ai/api/instantly/update/custom/tag` — Tool to update an existing custom tag's label or description. Use when you need to modify a custom tag used for organizing accounts and campaigns.
  - body: { id: string, label?: string, description?: string }
- `POST https://api.mcp.ai/api/instantly/update/inbox/placement/test` — Tool to update an inbox placement test. Use when you need to modify an existing inbox placement test by its ID.
  - body: { id: string, name?: string, tags?: string[], type?: integer, emails?: string[], status?: integer, schedule?: object, test_code?: string, text_only?: boolean, email_body?: string, automations?: object[], campaign_id?: string, description?: string, delivery_mode?: integer, email_subject?: string, sending_method?: integer, recipients_labels?: object[], not_sending_status?: string, timestamp_next_run?: string }
- `POST https://api.mcp.ai/api/instantly/update/lead` — Tool to update a lead's details. Use when you need to modify fields of an existing lead after identifying its ID.
  - body: { id: string, phone?: string, website?: string, last_name?: string, first_name?: string, company_name?: string, personalization?: string, lt_interest_status?: integer }
- `POST https://api.mcp.ai/api/instantly/update/lead/interest/status` — Tool to update a lead's interest status. Use when you need to set or reset a lead’s interest status for follow-up actions.
  - body: { list_id?: string, lead_email: string, campaign_id?: string, interest_value: integer, ai_interest_value?: integer, disable_auto_interest?: boolean }
- `POST https://api.mcp.ai/api/instantly/update/lead/list` — Tool to update details of a specific lead list by its ID. Use after verifying the list ID exists.
  - body: { id: string, name?: string, owned_by?: string, has_enrichment_task?: boolean }
- `POST https://api.mcp.ai/api/instantly/update/subsequence` — Tool to update a campaign subsequence entity. Use when you need to modify subsequence settings such as name, schedule, or triggered CRM statuses.
  - body: { id: string, name?: string, sequences?: object[], crm_statuses?: string[], parent_campaign?: string, subsequence_schedule?: object }
- `POST https://api.mcp.ai/api/instantly/update/workspace/current` — Tool to update the current workspace details. Use when you need to modify workspace settings such as name or logo URL.
  - body: { name?: string, org_logo_url?: string }
- `POST https://api.mcp.ai/api/instantly/verify/email` — Tool to initiate email verification. Use when you need to verify an email's deliverability before sending emails.
  - body: { email: string, webhook_url?: string }
- `POST https://api.mcp.ai/api/instantly/workspace/group/members/admin/get` — Tool to retrieve admin workspace details for the current sub workspace. Use when you need to get information about the admin workspace relationship, including workspace IDs and status.
- `POST https://api.mcp.ai/api/instantly/workspace/members/get` — Tool to retrieve details of a specific workspace member by ID. Use when you need information about a member of a workspace with associated user details.
  - body: { id: string }
- `POST https://api.mcp.ai/api/instantly/workspace/members/post` — Tool to add a new member to workspace with email and role. Use when you need to invite a new team member to the workspace with specific role and permissions.
  - body: { role: string, email: string, permissions?: string[] }

## Example prompts
- "What can I do in Instantly?"
- "Show me a summary of my Instantly account"

## More
- Page: https://mcp.ai/instantly
- Agent spec (llms.txt): https://mcp.ai/instantly/llms.txt
- Postman collection: https://mcp.ai/instantly/postman.json