AI assistants

AI assistants (MCP)

Connect Claude, ChatGPT and other MCP clients to your EmailMarketer.io account, choose what they may do, and see the tools they get.

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

  1. You add the URL to your assistant.
  2. The assistant opens the EmailMarketer.io sign-in page. Two-factor authentication works as usual.
  3. A consent screen asks what the assistant may do. Click Allow.
  4. 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