Skip to main content
Glama

Instantly MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
INSTANTLY_API_KEYYesYour Instantly API key from the Instantly dashboard integrations section

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
list_campaigns

List campaigns with optional filters and complete pagination support. COMPLETE PAGINATION: To get ALL campaigns, use one of these approaches:

  1. Set limit=100 or higher (automatically triggers complete pagination)

  2. Set get_all=true (forces complete pagination)

  3. Use limit="all" (string triggers complete pagination)

PAGINATION ALGORITHM: When requesting all campaigns, the tool will automatically:

  • Start with limit=100 per page

  • Continue fetching until next_starting_after is null or empty results

  • Report progress: "Retrieved 100... 200... 304 total campaigns"

  • Return summarized data to prevent size limits

  • Use get_campaign for full details of specific campaigns

FILTERS: search and status filters work with both single-page and complete pagination modes.

get_campaign

Get details of a specific campaign

create_campaign

Create a new email campaign with bulletproof three-stage workflow ensuring 100% success rate. Handles both simple requests ("create a campaign") and complex detailed specifications seamlessly.

INTELLIGENT WORKFLOW:

  • Simple Usage: Just provide basic info (name, subject, body) - tool automatically handles prerequisites

  • Advanced Usage: Specify all parameters for immediate creation

  • Guided Mode: Use stage parameter for step-by-step control

THREE-STAGE PROCESS:

  1. Prerequisite Check (stage: "prerequisite_check"): Validates accounts and collects missing required fields

  2. Campaign Preview (stage: "preview"): Shows complete configuration for user confirmation

  3. Validated Creation (stage: "create"): Creates campaign with fully validated parameters

AUTO-STAGE DETECTION: Tool automatically determines appropriate stage based on provided parameters for seamless user experience.

EXAMPLE USAGE:

// Simple: Tool handles everything create_campaign {"name": "My Campaign", "subject": "Hello", "body": "Hi there"} // Advanced: Full specification create_campaign { "name": "My Campaign", "subject": "Hello {{firstName}}", "body": "Hi {{firstName}},\n\nGreat to connect!", "email_list": ["verified@domain.com"], "daily_limit": 50 }
update_campaign

Update an existing campaign

get_campaign_analytics

Get analytics for campaigns

get_campaign_analytics_overview

Get analytics overview for all campaigns

list_accounts

List all sending accounts in the workspace. PREREQUISITE FOR CAMPAIGN CREATION: You MUST call this tool first before creating any campaigns to obtain valid email addresses for the email_list parameter. The returned accounts are the only valid sending addresses that can be used in campaigns.

CRITICAL FOR SUCCESS: Campaign creation will fail if you use email addresses that are not returned by this endpoint. Always use the exact email addresses from this response.

COMPLETE PAGINATION: To get ALL accounts, use one of these approaches:

  1. Set limit=100 or higher (automatically triggers complete pagination)

  2. Set get_all=true (forces complete pagination)

  3. Use limit="all" (string triggers complete pagination)

PAGINATION ALGORITHM: When requesting all accounts, the tool will automatically:

  • Start with limit=100 per page

  • Continue fetching until next_starting_after is null or empty results

  • Report progress: "Retrieved 100... 200... 304 total accounts"

  • Return complete dataset with validation

ACCOUNT STATUS: Look for accounts with status=1, setup_pending=false, warmup_status=1 for campaign eligibility.

update_account

Update a sending account

get_warmup_analytics

Get warmup analytics for one or more accounts. API REQUIREMENT: The Instantly API expects an array of email addresses, even for a single account.

list_leads

List leads with filters and pagination

create_lead

Create a new lead

update_lead

Update a lead

list_lead_lists

List all lead lists with pagination

create_lead_list

Create a new lead list

reply_to_email

Reply to an existing email. IMPORTANT: This can only be used to reply to existing emails, not to send new emails. You must provide the ID of an existing email to reply to. Use campaigns for sending new emails.

list_emails

List emails with filters and pagination

get_email

Get a specific email by ID

verify_email

Verify if an email address is valid. IMPORTANT: This feature may require a premium Instantly plan or specific API permissions. If you receive a 403 Forbidden error, check: 1) Your Instantly plan includes email verification, 2) Your API key has the required scopes, 3) Contact Instantly support to confirm feature availability.

list_api_keys

List all API keys

validate_campaign_accounts

Validate which accounts are eligible for campaign creation. This tool helps debug campaign creation issues by showing the status of all accounts and which ones meet the requirements for sending campaigns.

get_account_details

Get detailed information about a specific account including warmup status, SMTP settings, and eligibility for campaigns.

check_feature_availability

Check which premium features are available with your current Instantly plan and API key permissions.

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bcharleson/Instantly-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server