MCP server
Emma MCP by usefulapi
Read audiences, groups, mailings and campaign results without sending email or changing…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://emma.usefulapi.io/mcpInstall 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