Mailbase MCP server
by amintt2
README.md
# Mailbase MCP server
Connect Claude, Claude Code, Cursor, Codex, VS Code or any MCP client to
[Mailbase](https://mailbase.studio): send transactional email, run campaigns,
read and answer replies, check sending domains, and review prospecting drafts,
all from your agent.
```
https://mailbase.studio/api/mcp/mcp
```
It is a **remote** server (Streamable HTTP). There is nothing to install or run:
your client connects to the URL above, opens the Mailbase sign-in page, and
you pick the workspace and the permissions (read only, write, send) the agent
gets. OAuth handles the rest, so no API key is pasted anywhere.
| Resource | URL |
| --- | --- |
| Streamable HTTP endpoint | `https://mailbase.studio/api/mcp/mcp` |
| SSE endpoint (older clients) | `https://mailbase.studio/api/mcp/sse` |
| OAuth metadata | `https://mailbase.studio/.well-known/oauth-authorization-server` |
| Protected resource metadata | `https://mailbase.studio/.well-known/oauth-protected-resource` |
## Set it up
### Claude (claude.ai and Claude Desktop)
1. Settings → Connectors → **Add custom connector**.
2. Name it `Mailbase`, paste `https://mailbase.studio/api/mcp/mcp`.
3. Click **Connect**, sign in to Mailbase, choose the workspace and what Claude may do.
Custom connectors work on every Claude plan.
### Claude Code
The MCP server alone:
```sh
claude mcp add --transport http mailbase https://mailbase.studio/api/mcp/mcp
```
Or the full plugin (MCP server, workflow skills and `/mailbase:*` commands), from inside Claude Code:
```
/plugin marketplace add amintt2/mailbase-plugins
/plugin install mailbase@mailbase-plugins
/mcp # select "mailbase", sign in, pick a workspace
```
### Cursor
Add to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
```json
{
"mcpServers": {
"mailbase": {
"url": "https://mailbase.studio/api/mcp/mcp"
}
}
}
```
Then open Cursor Settings → MCP and click **Connect** next to `mailbase`.
### Codex
```sh
codex mcp add mailbase --url https://mailbase.studio/api/mcp/mcp
```
The ChatGPT / Codex plugin manifest is in [`plugins/mailbase/plugin.json`](plugins/mailbase/plugin.json).
### VS Code (GitHub Copilot agent mode)
Add to `.vscode/mcp.json`:
```json
{
"servers": {
"mailbase": {
"type": "http",
"url": "https://mailbase.studio/api/mcp/mcp"
}
}
}
```
### Any other client
Point it at `https://mailbase.studio/api/mcp/mcp` with the Streamable HTTP transport.
The client discovers OAuth from the metadata above. Ready-to-copy snippets are in [`clients/`](clients/).
## What the tools cover
| Area | Examples |
| --- | --- |
| Sending | Test sends, connect and verify domains, check DNS (`check_domain_dns`), manage senders, read the deliverability report |
| Campaigns | Create campaigns and templates, preflight, test, schedule or launch, A/B results, stats |
| Inbox | List and read replies, notes, tags, pipeline stages, reply, follow-ups |
| Contacts | Audiences, contacts, suppressions, exports, GDPR erasure |
| Workflows | Create, enroll, pause automation workflows |
| Prospecting | French company register (SIRENE) search, targets, prospect pool, AI drafts you approve one by one |
Two meta tools, `search_tools` and `run_program`, let an agent find the right tool
and run read-only multi-step lookups without loading every schema.
## Sending stays your decision
- Every tool is annotated: read-only tools are marked read-only, and every tool that
emails people or deletes data is marked destructive, so the client asks before running it.
- Launching a campaign or rolling out an A/B winner is refused unless the call confirms it.
- Mailbase applies its own rules to every send, whatever the client: unsubscribed, bounced
and complained addresses are skipped, daily caps and domain warm-up hold, and content is
screened for scams before anything leaves.
- A connection never does more than the workspace member who approved it.
## This repository
| Path | What it is |
| --- | --- |
| [`server.json`](server.json) | Entry for the [official MCP Registry](https://registry.modelcontextprotocol.io) |
| [`clients/`](clients/) | Config snippets for Claude Code, Codex, Cursor and VS Code |
| [`plugins/mailbase/`](plugins/mailbase/) | The Mailbase agent plugin: MCP config, skills and slash commands for Claude Code, plus the ChatGPT / Codex manifest |
The Claude Code marketplace you install from is [amintt2/mailbase-plugins](https://github.com/amintt2/mailbase-plugins).
## Pricing
Mailbase has a free plan with 200 emails a month and no card. Sending from your own
verified domain on the free plan needs a verified card (nothing is charged) and allows
3,000 emails a month. Paid plans, billed yearly: Starter €9/month for 50,000 emails a
month, Growth €29/month for 100,000, Scale €79/month for 300,000 (prices excl. VAT).
See [mailbase.studio/features/transactional-email](https://mailbase.studio/features/transactional-email).
## Related
- [mailbase-cli](https://github.com/amintt2/mailbase-cli): the `mailbase` command-line client
- [mailbase-examples](https://github.com/amintt2/mailbase-examples): `POST /api/v1/send` in Next.js, Express and Python
- [email-dns-check](https://github.com/amintt2/email-dns-check): SPF, DKIM, DMARC and MX checks
Docs: [MCP OAuth setup](https://mailbase.studio/docs/mcp-oauth) ·
[Claude connector](https://mailbase.studio/docs/claude-connector) ·
[Claude Code plugin](https://mailbase.studio/docs/claude-code-plugin).
Support: contact@mailbase.studio.
## License
MIT for the files in this repository. The Mailbase service itself is hosted at
[mailbase.studio](https://mailbase.studio) and is not open source.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues