Skip to content
MCP server

Emma MCP by usefulapi

Read audiences, groups, mailings and campaign results without sending email or changing…

Install
Runs
Remotely
Version
1.13.0
Listing updated
4 days ago

About Emma MCP by usefulapi

Emma MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read audiences, groups, mailings and campaign results without sending email or changing contacts.

Install

Run in a terminal

claude mcp add --transport http emma https://emma.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://emma.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "emma": {
      "url": "https://emma.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "emma": {
      "type": "http",
      "url": "https://emma.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "emma": {
      "serverUrl": "https://emma.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "emma": {
      "type": "http",
      "url": "https://emma.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (19)

Read directly from the server.

emma_list_groups
List the member groups (audience lists) of the Emma account with their active, opted-out and error member counts. Defaults to normal groups; group_types can add test and hidden groups.
emma_get_group
Get one member group with its member counts (active, opted-out, error).
emma_list_group_members
List the members of one group (email, status, custom fields). Paged: use next_start for more.
emma_list_members
List the members (contacts) of the whole audience: id, email, status (a active, o opted out, e error), custom fields, bounce count. Paged: use next_start for more. With count_only the reply is just the number of members.
emma_get_member
Get one member by id, with all custom fields, status, SMS status and bounce count.
emma_find_member_by_email
Find one member by email address, with all custom fields and status. A 404 means the address is not in the audience.
emma_get_member_groups
List the groups one member belongs to.
emma_get_member_mailings
The mailing history of one member: which mailings they were sent and what they did with them.
emma_list_fields
List the custom member fields of the account (shortcut names, display names, types).
emma_get_import
Status and results of one bulk member import (by import id), or, without an id, the list of all imports of the account.
emma_list_mailings
List mailings (campaigns): id, name, subject, sender, status (p pending, a paused, i injecting, s sending, x canceled, c complete, w waiting, u unapproved, f failed), type, recipient count, scheduled time. Defaults to standard and test mailings in all statuses, newest first. Paged: use next_start.
emma_get_mailing
Get one mailing in full: content (HTML and plain text), recipients (groups, searches, segments), links, schedule, status.
emma_list_mailing_members
List the individual members a mailing was sent to (not groups or searches). Paged: use next_start.
emma_get_response_summary
Month-by-month response statistics for the whole account: mailings, sent, delivered, bounced, opened, clicked, forwarded, opt-outs, sign-ups (test mailings excluded).
emma_get_mailing_response
Response summary of one mailing: recipients, sent, delivered, bounced, opened, clicked (unique and total), forwarded, opt-outs, sign-ups.
emma_list_mailing_links
The links of one mailing with their unique and total clicks.
emma_list_mailing_activity
Who did what with one mailing: members it was sent to (sends), still in the queue (in_progress), delivered or bounced (deliveries), opened (opens), clicked (clicks), forwarded, opted out (optouts) or signed up (signups). Each row has the member's email and timestamp. Paged: use next_start.
emma_list_searches
List the saved searches (dynamic segments) of the account, with their criteria.
emma_get_search_members
The members that currently match a saved search. Paged: use next_start.

Emma MCP by usefulapi FAQ

How do I add Emma MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http emma https://emma.usefulapi.io/mcp