Instantly

The Instantly MCP Server provides a transit service for email marketing and potential customer management functions of Instantly API v2

Marketing Developer tools #Email Marketing #Customer Management #Data Analysis #Account Monitoring Local .TypeScript

rating : 2.5 points

downloads : 33

update time : 2025-04-28

What is the Instantly MCP Server?

The Instantly MCP Server is a lightweight tool that provides you with access to email marketing and lead management functions through Instantly API v2. You can easily create, update, and delete leads, manage email accounts, and obtain detailed marketing analytics.

How to use the Instantly MCP Server?

Through simple commands or configuration file settings, you can start using the powerful functions of Instantly API v2 within a few minutes. Just enter your API key and run the server to quickly start and operate.

Use Cases

The Instantly MCP Server is very suitable for enterprises and individuals who need to efficiently manage email marketing campaigns and lead management. For example, you can easily track lead status, optimize email sending strategies, or monitor the health of email accounts.

Main Features

Create LeadCreate a new lead record through a simple API call.

List LeadsFilter and list existing leads by conditions.

Update LeadModify the information of an existing lead.

Delete LeadRemove lead records that are no longer needed.

List Marketing CampaignsList existing marketing campaigns in pages.

Test Account HealthCheck the connectivity and health of email accounts.

Get Warm-up AnalyticsView the warm-up performance data of email accounts.

Advantages and Limitations

Advantages

Quickly integrate the powerful functions of Instantly API v2.

A simple and easy-to-use command-line interface.

Support multiple email account and lead management operations.

Real-time monitoring of the health status of email accounts.

Limitations

Some advanced features may require additional configuration.

Some API endpoints are not fully implemented yet.

Dependent on the availability and stability of the Instantly API.

How to Use

Install the MCP Server

Download and install the MCP Server, ensuring that the environment meets the operating requirements.

Configure the API Key

Add your Instantly API key to the configuration file.

Start the Server

Run the MCP Server and start using the Instantly API.

Usage Examples

Create a New LeadCreate a new lead record through the API.

List Active Marketing CampaignsGet all currently active marketing campaigns.

Test Email Account HealthDetect the connectivity and performance of email accounts.

Frequently Asked Questions

How to obtain an Instantly API key?

How to handle API errors?

Which operating systems does the MCP Server support?

Related Resources

Instantly API Documentation

The official documentation for Instantly API v2.

GitHub Code Repository

The open-source code repository for the MCP Server.

User Community Forum

The communication platform for the Instantly user community.

🚀 Instant Configuration Guide

This guide provides a step-by-step process for installing, setting up, and contributing to the Instantly-MCP project.

🚀 Quick Start

Installation Steps

Clone the repository:

git clone https://github.com/bcharleson/Instantly-MCP.git
cd Instantly-MCP

Install dependencies:
```
npm install
```
Create a .env file and add your Instantly API key in the root directory:
```
INSTANTLY_API_KEY=your_api_key_here
```
⚠️ Important Note: Do not commit the .env file or API key to the version control system. The .gitignore file already includes the .env file to prevent accidental commits.
Build the project:
```
npm run build
```
Run the server:
```
node dist/index.js
```

🛠️ Development Setup

If you want to contribute to the project or develop locally:

Clone the repository:

git clone https://github.com/bcharleson/Instantly-MCP.git
cd Instantly-MCP

Install dependencies:
```
npm install
```
Create a .env file and add your Instantly API key in the root directory:
```
INSTANTLY_API_KEY=your_api_key_here
```
⚠️ Important Note: Do not commit the .env file or API key to the version control system. The .gitignore file already includes the .env file to prevent accidental commits.
Build the project:
```
npm run build
```
Run the server:
```
node dist/index.js
```

🤝 Contribution Guide

Contributions are welcome! If you'd like to contribute:

Fork the repository.
Create a new feature branch (git checkout -b feature/amazing-feature).
Make changes.
Commit your changes (git commit -m 'Add some amazing feature').
Push the branch (git push origin feature/amazing-feature).
Create a Pull Request.

Before submitting a Pull Request, please ensure the following:

Have you created tests for the new feature?
Do all the tests pass?
Have you updated the documentation if necessary?

📊 Tool Test Status

We have confirmed that all tools implemented in this MCP server work correctly with the Instantly API v2. The following table provides an overview of the test status for each tool:

#	Tool Name	Status	Notes
1	`instantly_list_campaigns`	✅ Certified	Successfully lists campaigns and supports pagination.
2	`instantly_list_leads`	❌ Not working	An "Invalid email address" API error occurs when retrieving the list of leads.
3	`instantly_delete_lead`	✅ Certified	Successfully deletes a lead by ID or email address.
4	`instantly_create_lead`	✅ Certified	Creates a new lead and works with correct data.
5	`instantly_get_lead`	✅ Certified	Successfully retrieves lead details by ID.
6	`instantly_update_lead`	✅ Certified	Updates existing lead information.
7	`instantly_list_accounts`	✅ Certified	Successfully lists all email accounts and displays statistical information.
8	`instantly_get_account`	✅ Certified	Successfully retrieves detailed account information.
9	`instantly_test_account_vitals`	✅ Certified	Successfully retrieves the health status of an account.

instantly_create_account

Create a new account.

Parameters

name : string*

Description

The name of the account.

Parameters

email : string*

Description

The email address of the account.

instantly_get_account

Get information about a single account.

Parameters

id : string*

Description

The unique identifier of the account.

instantly_list_accounts

List all accounts.

Parameters

page_size : number*

Description

The number of accounts to display per page.

Parameters

page_number : number*

Description

The page number to view.

instantly_update_account

Update account information.

Parameters

id : string*

Description

The unique identifier of the account.

Parameters

name : string*

Description

The new name of the account.

instantly_delete_account

Delete an account.

Parameters

id : string*

Description

The unique identifier of the account.

instantly_list_campaigns

List all campaigns.

instantly_get_campaign

Get information about a single campaign.

Parameters

id : string*

Description

The unique identifier of the campaign.

instantly_create_campaign

Create a new campaign.

Parameters

name : string*

Description

The name of the campaign.

instantly_update_campaign

Update the campaign status.

Parameters

id : string*

Description

The unique identifier of the campaign.

Parameters

status : string*

Description

The new status of the campaign.

instantly_delete_campaign

Delete a campaign.

Parameters

id : string*

Description

The unique identifier of the campaign.

instantly_create_lead

Create a new lead.

Parameters

name : string*

Description

The name of the lead.

Parameters

contact_info : string*

Description

Contact information.

instantly_get_lead

Get information about a single lead.

Parameters

id : string*

Description

The unique identifier of the lead.

instantly_list_leads

List all leads.

Parameters

page_size : number*

Description

The number of leads to display per page.

Parameters

page_number : number*

Description

The page number to view.

instantly_update_lead

Update lead information.

Parameters

id : string*

Description

The unique identifier of the lead.

Parameters

new_info : object*

Description

New lead information.

instantly_delete_lead

Delete a lead.

Parameters

id : string*

Description

The unique identifier of the lead.

Featured MCP Services

Markdownify MCP

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

TypeScript

116

4.3 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

587

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

TypeScript

5.3K

4.7 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご