Instantly MCP Server

A Model Context Protocol (MCP) server for Instantly.ai email campaign management.

Quick Start

Installation

npm install
npm run build

Configuration

export INSTANTLY_API_KEY="your-api-key-here"
npm start

Server available at: http://localhost:3000/mcp

Claude Desktop Setup (Local)

{
  "mcpServers": {
    "instantly": {
      "command": "node",
      "args": ["/path/to/instantly-mcp/dist/index.js"],
      "env": {
        "INSTANTLY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Remote HTTP Endpoint

Production Endpoint

URL: https://mcp.instantly.ai/mcp

Authentication Methods

1. URL-based Authentication

https://mcp.instantly.ai/mcp/YOUR_API_KEY

2. Header Authentication

URL: https://mcp.instantly.ai/mcp
Header: Authorization: YOUR_API_KEY

Note: Bearer token prefix is not required

Usage with MCP Clients

Configure your MCP client to use the remote endpoint:

{
  "mcpServers": {
    "instantly": {
      "url": "https://mcp.instantly.ai/mcp",
      "headers": {
        "Authorization": "your-api-key-here"
      }
    }
  }
}

Available Tools

Campaign Management

• create_campaign - Create email campaigns with bulletproof timezone validation
• list_campaigns - List campaigns with filtering
• get_campaign - Get campaign details
• update_campaign - Update campaign settings
• activate_campaign - Start campaigns
• pause_campaign - Pause campaigns

Analytics

• get_campaign_analytics - Campaign performance metrics
• get_campaign_analytics_overview - Overview across all campaigns
• get_daily_campaign_analytics - Daily analytics with date filtering
• get_warmup_analytics - Email warmup analytics

Lead Management

• create_lead - Add leads to campaigns
• list_leads - List leads with filtering
• get_lead - Get lead details
• update_lead - Update lead information
• create_lead_list - Create lead lists
• list_lead_lists - List all lead lists

Email Operations

• list_emails - List emails with filtering
• get_email - Get email details
• reply_to_email - Reply to emails (⚠️ sends real emails)
• verify_email - Verify email deliverability
• count_unread_emails - Count unread emails

Account Management

• list_accounts - List email accounts
• create_account - Create email accounts with IMAP/SMTP
• update_account - Update account settings
• get_account_details - Get detailed account info
• get_account_info - Get account status
• pause_account - Pause accounts
• resume_account - Resume accounts
• delete_account - Delete accounts (⚠️ destructive)

Warmup & Health

• enable_warmup - Enable email warmup
• disable_warmup - Disable email warmup
• test_account_vitals - Test account connectivity

Utilities

• validate_campaign_accounts - Validate accounts for campaigns
• list_api_keys - List API keys

Authentication

Environment Variable

export INSTANTLY_API_KEY="your-key"

URL Authentication

https://server.com/mcp/your-key

Header Authentication

Authorization: Bearer your-key

Features

• Streamable HTTP Transport - Remote MCP server at https://mcp.instantly.ai/mcp
• Bulletproof Timezone System - 26 verified working timezones with intelligent fallbacks
• Production Ready - Rate limiting, error handling, pagination
• Instantly.ai API v2 - Full compatibility with latest API
• Dual Authentication - URL-based and header-based API key authentication
• Dual Transport - STDIO and HTTP streaming support

License

MIT