MCP Server

Connect AI agents like Claude, GPT, and Cursor to manage your PushMail email infrastructure through natural language.

The PushMail MCP server lets AI agents — Claude, GPT, Cursor, and others — manage your email infrastructure through natural language. Create contacts, build sequences, send campaigns, and check analytics without writing code.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. Instead of copying and pasting API calls, you tell your AI assistant what you want and it calls the PushMail API for you.

Installation

You'll need a PushMail API key. Go to your dashboard to create one, then configure your AI client below.

Claude Desktop

Add to your claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "pushmail": {
      "command": "npx",
      "args": ["-y", "@pushmail/mcp"],
      "env": {
        "PUSHMAIL_API_KEY": "pm_live_YOUR_KEY"
      }
    }
  }
}

Claude Code

claude mcp add pushmail -- npx -y @pushmail/mcp

# Set your API key in your environment
export PUSHMAIL_API_KEY="pm_live_YOUR_KEY"

Cursor

Add to your .cursor/mcp.json:

.cursor/mcp.json

{
  "mcpServers": {
    "pushmail": {
      "command": "npx",
      "args": ["-y", "@pushmail/mcp"],
      "env": {
        "PUSHMAIL_API_KEY": "pm_live_YOUR_KEY"
      }
    }
  }
}

You can also pass the API key as a CLI argument: --api-key pm_live_YOUR_KEY

Available tools

The MCP server exposes 15 tools that cover the full PushMail API. All tools are prefixed with pushmail_ to avoid conflicts with other MCP servers.

Tool	Description
`pushmail_get_account`	Get your org info, credit balance, and usage stats
`pushmail_list_sites`	List all sites in your organization
`pushmail_create_site`	Create a new site for sending emails
`pushmail_list_contacts`	Search and list contacts with pagination
`pushmail_create_contact`	Create a contact with tags and list assignments
`pushmail_update_contact`	Update a contact's fields
`pushmail_manage_list`	Create a list, or add/remove contacts from a list
`pushmail_manage_tags`	Create a tag for a site
`pushmail_list_templates`	List all email templates
`pushmail_create_template`	Create a new email template
`pushmail_list_sequences`	List sequences with their status
`pushmail_manage_sequence`	Create, activate, pause, or enroll contacts in a sequence
`pushmail_list_campaigns`	List campaigns with stats
`pushmail_send_campaign`	Create and send or schedule a campaign
`pushmail_list_events`	Recent email events (opens, clicks, bounces)

Example conversations

Here are some things you can ask your AI assistant once the MCP server is connected:

Prompt	Tools used
"Show me all my sites and how many contacts each has"	`pushmail_list_sites`, `pushmail_list_contacts`
"Create a new contact jane@acme.com on site 1, tag her as 'enterprise'"	`pushmail_create_contact`
"Build a 3-email welcome sequence for my newsletter site"	`pushmail_create_template`, `pushmail_manage_sequence`
"Send a campaign to everyone tagged 'launch-list' using template 5"	`pushmail_send_campaign`
"What's my open rate on last week's campaigns?"	`pushmail_list_campaigns`, `pushmail_list_events`

Security

Your API key is only sent to the PushMail API — the MCP server runs locally on your machine and communicates with your AI client over stdio. No data is sent to third parties.

On this page