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.
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
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
One click: Add MailSenpai to Cursor
Or add it to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
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)
.mcp.json
Remote HTTP configuration for compatible MCP clients
mcp.json
Agent Plugins 1.0.0 configuration, using the streamable-http transport
.claude-plugin/plugin.json
Claude Code plugin manifest
.cursor-plugin/plugin.json
Cursor plugin manifest
plugin.json
Agent Plugins manifest for catalog discovery and compatible clients
gemini-extension.json
Gemini CLI extension manifest
assets/logo.png, assets/logo-400.png
Logo (512×512 and 400×400)
Agent Plugins Directory
The hosted connector is indexed in the Agent Plugins Directory. The directory reads the public plugin.json and mcp.json manifests. It can discover the hosted server without access to its source code. Follow the OAuth setup above after installation.
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.