EmailMarketer.io runs an MCP server, so AI assistants that support the Model Context Protocol can read your account and, if you allow it, change data or send. There is nothing to install.
Connector URL
https://app.emailmarketer.io/mcp
The server uses HTTP transport and OAuth sign-in. You find the same URL in the app under API & webhooks → Connected AI assistants, with a copy button.
How the connection works
- You add the URL to your assistant.
- The assistant opens the EmailMarketer.io sign-in page. Two-factor authentication works as usual.
- A consent screen asks what the assistant may do. Click Allow.
- The connection gets its own key. It appears on your API keys page as
AI connector: <assistant name>.
A connection that is not used for 30 days must sign in again. Disconnect any assistant from Connected assistants with the delete icon on its row.
Permissions
| Permission | Scope | What it allows |
|---|---|---|
| Read | read |
Reports, lists, segments, campaigns, journeys, templates. Always on |
| Change data | write |
Create, edit, copy, archive and delete |
| Send | send |
Tag subscribers, confirm opt-ins, enrol subscribers in journeys and other actions that can send email |
Give the smallest permission that does the job. Deletes always return a preview first. The assistant must repeat the call with a confirm token, which works once and expires after 10 minutes.
Set up your assistant
Claude and Claude Desktop
Settings → Connectors → Add custom connector. Paste the URL, click Add, then Connect, sign in and click Allow.
ChatGPT
Settings → Apps and Connectors → Advanced, turn on Developer mode. Click Create, paste the URL and choose OAuth for authentication.
Claude Code
claude mcp add --transport http emailmarketer https://app.emailmarketer.io/mcp
Then run /mcp, pick emailmarketer and choose Authenticate.
Codex CLI
codex mcp add emailmarketer --url https://app.emailmarketer.io/mcp
codex mcp login emailmarketer
Gemini CLI
Add this to ~/.gemini/settings.json, then run /mcp auth emailmarketer:
{
"mcpServers": {
"emailmarketer": { "httpUrl": "https://app.emailmarketer.io/mcp" }
}
}
Other clients
Any client that supports remote MCP servers over HTTP with OAuth connects the same way: give it the connector URL and sign in.
Agent keys for clients without a browser
Some clients cannot open a sign-in page. For those, create an agent key under API & webhooks → Connected AI assistants → Create agent key, and send it as a bearer token. An agent key has the same permissions, limits and confirmation step as an OAuth connection.
Claude Code, in .mcp.json:
{
"mcpServers": {
"emailmarketer": {
"type": "http",
"url": "https://app.emailmarketer.io/mcp",
"headers": { "Authorization": "Bearer ${EM_AGENT_KEY}" }
}
}
}
Codex CLI:
codex mcp add emailmarketer --url https://app.emailmarketer.io/mcp --bearer-token-env-var EM_AGENT_KEY
Gemini CLI: add "headers": { "Authorization": "Bearer $EM_AGENT_KEY" } next to httpUrl.
Tools
R is Read, W is Change data, S is Send. A tick (✓) means the tool always asks for confirmation first.
Account, lists and fields
| Tool | Permission | What it does |
|---|---|---|
get_account |
R | Name, email, company, time zone, plan and sending usage |
list_lists, get_list |
R | Lists with counts, or one list |
get_lists_overview |
R | All lists, with fields, segments, tags and engagement if asked |
get_list_analytics |
R | One list’s report: activity, bounces, engagement tiers, mailbox providers, send times, sources, statuses, tenure |
clone_list |
W | Empty copy of a list with its settings and fields |
archive_list, unarchive_list |
W | Hide or show a list. Nothing is deleted |
create_custom_field, update_custom_field |
W | Add or edit a custom field |
copy_custom_fields |
W | Copy all fields of one list to another |
delete_list |
W ✓ | Delete a list with its subscribers |
delete_custom_fields |
W ✓ | Delete up to 20 fields |
Subscribers and tags
| Tool | Permission | What it does |
|---|---|---|
get_subscriber |
R | One subscriber with fields, status, tags, segments, journeys and revenue |
search_subscribers |
R | Find an address across lists, or match rules in one list |
browse_subscribers |
R | A page of up to 100 subscribers by status or segment |
get_subscriber_activity |
R | Sends, opens, clicks, bounces, tags, journeys and website events |
list_tags |
R | A list’s tags with counts |
create_tag, update_tag |
W | Create or rename a tag |
delete_tag |
W ✓ | Delete a tag |
delete_subscribers |
W ✓ | Delete up to 100 subscribers |
tag_subscribers, untag_subscribers |
S | Tag or untag up to 100 subscribers. Tags can start journeys |
optin_subscriber |
S | Confirm a pending subscription |
Segments
| Tool | Permission | What it does |
|---|---|---|
list_segments |
R | Segments of one list |
get_segment_count |
R | Subscribers matching one segment |
get_segment_rule_vocabulary |
R | Valid rule fields and operators |
copy_segments |
W | Copy all segments of one list to another |
delete_segments |
W ✓ | Delete up to 20 segments |
Campaigns and templates
| Tool | Permission | What it does |
|---|---|---|
list_campaigns, get_campaign |
R | Campaigns by status or search, or one campaign |
get_campaign_stats |
R | Sent, delivered, opens, clicks, unsubscribes, bounces, complaints |
get_campaign_counts |
R | Campaigns per status |
get_campaign_recipients |
R | Recipient count of an unsent campaign |
get_campaign_recipient_activity |
R | Who opened, clicked, bounced, unsubscribed, forwarded or converted |
get_campaign_link_clicks |
R | Clicks per link, or who clicked |
get_campaign_abtest_results |
R | Results per variation and the winner |
list_email_templates |
R | Templates: name, subject and sender |
copy_campaign |
W | New unscheduled copy of a campaign |
delete_campaigns |
W ✓ | Delete up to 20 campaigns. A campaign that is sending is refused |
Journeys
| Tool | Permission | What it does |
|---|---|---|
list_journeys, get_journey |
R | Journeys with trigger and status, or one journey with its steps |
get_journey_stats |
R | Results per step or mailbox provider |
get_journey_action_subscribers |
R | Subscribers an email step reached |
list_subscriber_journeys |
R | Journeys one subscriber is or was in |
clone_journey |
W | Copy a journey. The copy is off |
delete_journeys |
W ✓ | Delete up to 10 journeys. They must be off first |
exit_subscriber_from_journey |
S | Take one subscriber out of a journey |
trigger_subscribers_into_journey |
S | Enrol a list or segment into an active journey |
Prompts and resources
The server also offers ready prompts (plan_campaign, reengage_inactive, build_journey, list_hygiene, explain_campaign_results) and resources (account://policy, account://lists, account://lists/<id>/segments, account://campaigns/recent).
Errors for agent keys
| Code | HTTP | Meaning |
|---|---|---|
100010 |
403 | The key’s scope does not allow this command |
100011 |
429 | The key’s usage budget is used up |
100012 |
409 | Confirmation needed. The response has Preview and ConfirmToken. Repeat the call with ConfirmToken |
100013 |
409 | The confirm token is invalid, expired, used, or the parameters changed |
100014 |
403 | An agent key was sent together with another credential |
100015 |
403 | Command and the path name different commands |
100016 |
403 | A refused parameter, or an ID the account does not own |