Repository avatar
AI Tools
v1.0.1
active

mailbase

io.github.amintt2/mailbase

Email from your agent: transactional sends, campaigns, reply inbox, domains and DNS checks.

Documentation

Mailbase MCP server

Connect Claude, Claude Code, Cursor, Codex, VS Code or any MCP client to Mailbase: 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.

ResourceURL
Streamable HTTP endpointhttps://mailbase.studio/api/mcp/mcp
SSE endpoint (older clients)https://mailbase.studio/api/mcp/sse
OAuth metadatahttps://mailbase.studio/.well-known/oauth-authorization-server
Protected resource metadatahttps://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:

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):

{
  "mcpServers": {
    "mailbase": {
      "url": "https://mailbase.studio/api/mcp/mcp"
    }
  }
}

Then open Cursor Settings → MCP and click Connect next to mailbase.

Codex

codex mcp add mailbase --url https://mailbase.studio/api/mcp/mcp

The ChatGPT / Codex plugin manifest is in plugins/mailbase/plugin.json.

VS Code (GitHub Copilot agent mode)

Add to .vscode/mcp.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/.

What the tools cover

AreaExamples
SendingTest sends, connect and verify domains, check DNS (check_domain_dns), manage senders, read the deliverability report
CampaignsCreate campaigns and templates, preflight, test, schedule or launch, A/B results, stats
InboxList and read replies, notes, tags, pipeline stages, reply, follow-ups
ContactsAudiences, contacts, suppressions, exports, GDPR erasure
WorkflowsCreate, enroll, pause automation workflows
ProspectingFrench 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

PathWhat it is
server.jsonEntry for the official MCP Registry
clients/Config snippets for Claude Code, Codex, Cursor and VS Code
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.

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.

Related

Docs: MCP OAuth setup · Claude connector · Claude Code plugin. Support: contact@mailbase.studio.

License

MIT for the files in this repository. The Mailbase service itself is hosted at mailbase.studio and is not open source.

No installation packages available.