MailerSend
Knowledge base

How to connect MailerSend's MCP with your AI tools

The MailerSend MCP (Model Context Protocol) server can be integrated with your AI tools in just a few steps - no downloads or extensive configuration needed. This guide will walk you through how to get started with various AI platforms.

Currently supported AI tools

The MailerSend MCP server is designed to work with any MCP-compatible client. The following tools currently support MCPs, and have been tested with MailerSend:

AI tool matrix showing the tools and plans that currently support MCPs and have been tested with MailerSend.

A note on data privacy and authorization

Before you connect, it's important to understand what this means for your data.

By connecting your AI tool to the MailerSend MCP server, you are granting the AI tool permission to access and manage your MailerSend data (like email activity, API tokens, recipient data, and domain settings) on your behalf.

MailerSend does not send any of your data to an AI tool. You are in full control. This connection simply enables the AI tool you choose to communicate with your MailerSend account when you give it a command.

Claude (Desktop or Web)

These steps work for both the desktop and web app.

  1. Make sure you have the latest version of Claude installed.

  2. In the Claude chat interface, click the + icon next to the text input field, then select Connectors.

  3. Click Add connector, then Browse connectors.

  4. Search for MailerSend and click Connect to Claude.

  5. If you're not already signed in, the Claude website will open so you can log in.

  6. Claude will request access to the MailerSend Model Context Protocol (MCP) server. Click Approve.

  7. Claude will redirect you to the MailerSend app in your browser. Choose the account you want to connect.

  8. Review the permissions screen and click Authorize.

  9. Once authorized, MailerSend will redirect you back to Claude. The connection is now active, and you can use the MailerSend MCP.

Claude authorization screen showing 'Claude is requesting access' to the MailerSend MCP Server, with Cancel and Approve buttons.

VSCode

You can integrate the MCP with VSCode via a simple one-click installation.

What you'll need before you start

  • The Visual Studio Code app installed on your computer

  • The GitHub Copilot extension installed and enabled in VSCode.

How to connect

  1. To connect MailerSend, simply click the link below to begin the installation process in VSCode.

    Connect MailerSend to VSCode

  2. A pop-up will appear asking for permission to open VSCode. Click Allow.

  3. In VSCode, click the Install button to complete the setup. You can start, stop and restart the server by clicking the settings icon next to the Uninstall button.

That’s it! The MailerSend MCP is active and ready to use in VSCode. In the Copilot chat view, just below the text input field, select Agent mode from the dropdown. You can view and select the tools you want to use by clicking the 'Configure tools' icon.

You can enter a prompt in the chat box, and the relevant tools will be invoked. By default, you'll need to confirm each action before it runs. Simply click Continue, or click the arrow to always allow actions to run without confirmation, or allow for the session or workspace.

Before confirming the action, you can also check and edit the input parameters.

Cursor

You can add the MailerSend MCP to Cursor via one-click installation.

  1. First, make sure you have the Cursor application installed on your computer.

  2. To add the MCP, click the link below to begin the connection process.
    Add to Cursor

  3. A security prompt will appear asking for permission to open Cursor. Click Allow.

  4. Click the Install button to start the setup.

  5. The MailerSend connector will show a status message. Click the link that says Needs login to start the authorization.

  6. Review the permissions and click Authorize.

  7. In the last pop-up window that appears, click Open to finalize the connection.

Tool limits for Cursor's Free plan

If you are using Cursor's Free plan, you might see an “Exceeding total tools limit” warning. This is because the free plan currently supports a maximum of 40 active tools from a single connector.

How to manage this: You have full control over which tools are active. To stay within the limit, you can go to the MailerSend MCP connector settings within Cursor and click on individual tools (e.g., delete_recipient, get_sender_identity) to enable or disable them as needed. This allows you to customize the toolset for your current task.

ChatGPT

To connect the MailerSend MCP to ChatGPT, you'll need a Pro or Plus plan.

How to connect our MCP to ChatGPT: 

  1. In ChatGPT, click on your profile in the bottom left-hand corner and select Settings.

  2. Go to Connectors > Advanced Settings and toggle Developer Mode. 

  3. Go Back and hit Create in the top right-hand corner.

  4. In the New Connector modal, fill out the details as follows:

    a. Name: MailerSend (This is for your own reference)

    b. MailerSend MCP server URL: https://mcp.mailersend.com/mcp 

  5. Tick the “I trust this application” checkbox at the bottom and click Create.  

  6. You will be automatically redirected to the MailerSend website in your browser. Choose the account you want to connect to.

  7. Review the permissions and click the Authorize button.

You're now connected! To start using the MCP in ChatGPT:

  1. In a new chat, click the + icon, then More, and select Developer Mode. 

  2. Click Add Sources and toggle MailerSend. You can now start asking.

Gemini CLI

You can integrate Gemini CLI with the MailerSend MCP. Check out our developer guide to learn more.

Full list of available tools

The MCP gives your AI tool access to MailerSend tools it can use to manage your account and perform tasks. Here are the available tools:

Domain management

Activity and Analytics

  • add_domain

  • delete_domain

  • get_domain

  • get_domain_recipients

  • list_domains

  • update_domain_settings

  • verify_domain

  • get_dns_records

  • get_activity

  • get_analytics_by_date

  • get_opens_by_country

  • get_opens_by_reading_environment

  • get_opens_by_user_agent

  • list_activities

Webhook management

Template management

  • create_webhook

  • delete_webhook

  • get_webhook

  • list_webhooks

  • update_webhook

  • delete_template

  • get_template

  • list_templates

Email sending

Email verification

  • delete_scheduled_message

  • get_bulk_email_status

  • get_message

  • get_scheduled_message

  • list_messages

  • list_scheduled_messages

  • send_bulk_email

  • send_email

  • create_verification_list

  • get_async_verification_status

  • get_verification_list

  • get_verification_results

  • list_verification_list

  • verify_email

  • verify_email_async

  • verify_list

Example prompts

To give you a better idea of how you could use the MCP, here are a few example prompts:

  • “Tell me the top 3 user agents for opens for all of my domains.”

  • “Create a webhook for the domain test.com. Use the webhook URL https://webhook.site/example and configure it to receive events for Opened and Clicked. Name the webhook ‘Test opens and clicks’.”

  • “Identify the 3 emails that got the most spam complaints in the last quarter. Tell me what they have in common.”

  • "Schedule an email with the Scheduled Maintenance template to go out at 10:00 AM tomorrow. The {{maintenance_period}} variable should be set as 10:00 PM - 11:00 PM and the {{date}} variable as August 8."

For more information and examples of how to use the MCP, check out our developer guide.

Need more info?

Feel free to reach out to mcp@mailersend.com. A member of our support team will gladly assist you.