REST API and MCP
Everything the dashboard does, from code or an AI assistant
The REST API and the MCP server run the same 42 actions as the dashboard, with the same checks: plan limits, sender rules, pre-send checks, campaigns paused for their bounce or complaint rates, blocked accounts and first sends in steps.
REST APIJSON in and out
https://mailcheap.ai/api/v1MCP serverStreamable HTTP
https://mailcheap.ai/mcp- 1
Create an API key
On the API keys page. Full access for scripts and AI assistants; signups only for signup forms in your website's code. Keys are shown once.
- 2
Make a request
Every request sends the key as a bearer token. This one lists your newsletters with their settings.
Terminal curl https://mailcheap.ai/api/v1/newsletters \ -H "Authorization: Bearer $MAILCHEAP_API_KEY" - 3
Or connect an AI assistant
One command for Claude Code. Codex and Cursor take a few lines, and ChatGPT, Claude and Grok Bot connect with your sign-in, on the MCP page.
Terminal claude mcp add --transport http --scope user mailcheap https://mailcheap.ai/mcp \ --header "Authorization: Bearer $MAILCHEAP_API_KEY"
What you can do
Overview1Subscribers, email results and sends per hour, as on the dashboard's first page.Newsletters5Sender, postal address, welcome and confirmation emails, list cleanup and archive.Campaigns16Drafts, test emails, scheduling, sending, sending in steps and reports.Contacts6Search, signups, imports with checks, status changes and exports.Domains4Own sending domains with their DNS records, and the shared address.Images2Pictures for campaign content, on MailCheap's CDN, kept in the account's library to use again.API keys5Keys for the REST API and MCP.Billing3Plan, usage and links to Stripe to change plan.
For agents reading this
- /llms.txt lists these pages and every endpoint.
- /llms-full.txt is the whole reference in Markdown.
- /api/v1/openapi.json is the API as OpenAPI 3.1, made from the same schemas as the MCP tools.