bcharleson/instantly-mcp
3.4
If you are the rightful owner of instantly-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for Instantly.ai email campaign management.
Tools
5
Resources
0
Prompts
0
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
