MailSenpaiDocumentation
How to use MailSenpai MCP
MailSenpai MCP is the server that lets an AI assistant (Claude, ChatGPT or another MCP-compatible client) work with your MailSenpai account: lists, subscribers, segments, templates, campaigns, reports and transactional emails. The assistant only uses the permissions of your plan.
Before you start
- A MailSenpai account with AI access turned on. If it is not active, write to supporto@mailsenpai.com.
- An AI client that supports remote MCP servers with OAuth authentication.
Server URL
https://mcp.mailsenpai.com/mcpStreamable HTTP transport. OAuth 2.0 authentication with dynamic client registration and PKCE (S256): no API keys needed, you sign in with your MailSenpai email and password on the authorization page.
Connect it
Claude
Settings, then Connectors, then "Add custom connector". Paste the server URL, select Connect and sign in with your MailSenpai account.
ChatGPT
From settings, add a custom connector (app) with the server URL and OAuth authentication. Depending on your ChatGPT plan, developer mode may be required.
Other MCP clients
Add a remote MCP server with the URL above. On first use the client opens the MailSenpai sign-in page: sign in, accept the Terms and Privacy Notice and you are sent back to the client.
What the tools can do
| Area | What the assistant can do | Type |
|---|---|---|
| Account | See permissions, plan limits and visible lists | Read |
| Lists and fields | List, create, edit and copy lists and custom fields | Read and write |
| Segments | Create segments with conditions and read their subscribers | Read and write |
| Subscribers | Search, add, update, unsubscribe; imports within plan limits | Read and write |
| Email templates | List, search, create and update templates | Read and write |
| Campaigns | Draft, schedule, pause; sending only with explicit confirmation | Read and write |
| Reports and bounces | Campaign statistics and recorded bounces | Read |
| Transactional emails | List and, if your plan allows it, create transactional emails | Read and write |
For example, you can ask: "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".
Plan-based permissions
The token only receives the permissions of your MailSenpai plan and role, even if the client asks for more. Sending, scheduling and deleting require explicit confirmation and are available only if your plan includes them. Every call is logged and subject to rate limits.
Disconnect
Remove the connector from your AI client's settings. Issued access expires on its own; to revoke it immediately, write to supporto@mailsenpai.com.
Also listed on
SmitheryGlamaOfficial MCP Registry (com.mailsenpai/mcp)
Privacy and support
How we handle data: Privacy Notice and Consent. Terms of use: Terms. Support: supporto@mailsenpai.com.