The com.mailsenpai/mcp Model Context Protocol (MCP) server manages MailSenpai email marketing workflows. It supports managing email lists and subscribers, templates, and campaigns, including EU and OAuth-based access.
🛠️ Key Features
Manage MailSenpai email lists
Manage subscribers
Manage templates
Manage campaigns
Supports EU scope
Uses OAuth
🚀 Use Cases
Administer MailSenpai mailing lists and subscriber records
Create and maintain email templates
Run and manage email campaigns in EU and OAuth contexts
⚡ Developer Benefits
Centralizes MailSenpai marketing management for MCP clients
Provides structured access to lists, subscribers, templates, and campaigns
⚠️ Limitations
Scope is limited to MailSenpai email marketing entities (lists, subscribers, templates, campaigns) and EU/OAuth contexts
Manage MailSenpai email marketing from your AI assistant: lists, subscribers, segments, templates, draft campaigns and campaign stats.
This is the official MCP server of MailSenpai, an email marketing platform made in Italy with servers and data in the EU. It is a hosted, remote MCP server: there is nothing to install or run locally.
About this repository. It contains only documentation and client manifests (the official MCP Registry entry and configuration files for Claude, Cursor, Gemini CLI and other MCP clients). The server source code is not published here. The server runs at the URL below and is operated by MailSenpai.
Endpoint
https://mcp.mailsenpai.com/mcp
Transport
Streamable HTTP
Authentication
OAuth 2.1 (authorization code with PKCE S256, dynamic client registration). No API keys.
An MCP client that supports remote servers with OAuth.
On first use, the client opens the MailSenpai sign-in page. Sign in with your MailSenpai email and password, review the requested access, accept the terms and you are sent back to the client. Your password is never shared with the AI client.
What the tools can do
The server exposes 74 tools, each annotated as read-only, write or destructive.
Area
What the assistant can do
Type
Account
See permissions, plan limits and visible lists
Read
Domain DNS check
Check the SPF, DKIM, DMARC and MX records of any domain, with what to fix and the values to publish (check_domain_dns)
Read
Blacklist checks
Check public IPs and domains against email blocklists, with results and official removal links (check_blacklist)
Read
Email spam tests
Start a test (start_email_spam_test), then read its state and score (get_email_spam_test_result). Starting creates a test and emails instructions; it does not send the test message for you
Read and write
Lists and custom fields
List, view, create, update, copy and delete lists and fields
Read and write
Segments
Create segments with conditions, update them and read their subscribers
Read and write
Subscribers
Search by email across lists, add, update, confirm, unsubscribe or delete; imports within plan limits
Read and write
Email templates
List, search, view, create, update and delete templates
Read and write
Campaigns
Create drafts, copy, schedule, pause or cancel
Read and write
Reports and bounces
Campaign statistics and recorded bounces
Read
Transactional emails
List and view them, and create them when the plan allows it
Read and write
Reference data
Countries and zones, field types and segment operators
Read
Example prompts:
"List my lists and how many confirmed subscribers they have."
"Create a draft campaign for the Customers list using the Welcome template."
"Summarize the statistics of my last five campaigns."
"Check the SPF, DKIM and DMARC records of example.com and tell me what to fix."
"Create a segment of subscribers who joined in the last 30 days."
Permissions and confirmations
The access token only receives the permissions of your MailSenpai plan and role, even if the client asks for more.
Deleting requires confirm_delete, sending requires confirm_send. Sending, scheduling and deleting are available only if your plan includes them.
Settings → Connectors → Add custom connector. Name: MailSenpai, URL: https://mcp.mailsenpai.com/mcp. Select Connect and sign in with your MailSenpai account.
Claude Code
bash
claude mcp add --transport http mailsenpai https://mcp.mailsenpai.com/mcp
Then run /mcp inside Claude Code and choose Authenticate for mailsenpai.
This repository is also a Claude Code plugin (.claude-plugin/plugin.json + .mcp.json).
ChatGPT
In ChatGPT settings, add a custom connector (app) with the URL https://mcp.mailsenpai.com/mcp and OAuth authentication, then sign in with your MailSenpai account. Depending on your ChatGPT plan, developer mode may be required.
Cursor shows a Needs login button next to the server: click it to sign in.
Cline
Open the MCP Servers panel → Remote Servers, name mailsenpai, URL https://mcp.mailsenpai.com/mcp, transport Streamable HTTP. Or edit cline_mcp_settings.json:
Add a remote MCP server with the URL https://mcp.mailsenpai.com/mcp. Clients that only support local (stdio) servers can use a bridge such as mcp-remote:
Remove the connector from your AI client's settings. Issued access expires on its own; to revoke it right away, contact support from https://mcp.mailsenpai.com/support.
Files in this repository
File
Purpose
server.json
Entry of the official MCP Registry (com.mailsenpai/mcp)
The files in this repository (README, manifests and configuration examples) are released under the MIT License. The license does not cover the MailSenpai service or the hosted MCP server, whose source code is not included here.
Install
Remote endpoint
Streamable HTTP
Hosted server - connect over the network, no local install.
