emma_list_groups
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.
limitstartgroup_typesio.usefulapiPublished by usefulapi.ioOfficial publisherv1.9.4Updated Nov 7, 2026
Read audiences, groups, mailings and campaign results without sending email or changing contacts.
The publisher's own server: Ably MCP by usefulapi
Read-only access to an Emma email marketing account: audiences, groups, members, mailings and campaign response metrics.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Femma/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"emma-by-usefulapi": {
"type": "http",
"url": "https://emma.usefulapi.io/mcp"
}
}
}Connect at https://emma.usefulapi.io/mcp.
https://emma.usefulapi.io/mcp.claude mcp add --transport http emma https://emma.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Emma credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/emma/
Connect your Emma credentials to access your account through usefulapi.
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pro covers this server only. Subscribe with emma_upgrade (it returns a Stripe Checkout link). Cancel any time with emma_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running emma_upgrade before then undoes the cancel. Or write to [email protected].
Source: servers/emma/README.md at commit 4046075
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.
limitstartgroup_typesGet a group
Get one member group with its member counts (active, opted-out, error).
group_idrequiredList group members
List the members of one group (email, status, custom fields). Paged: use next_start for more.
limitstartgroup_idrequiredinclude_deletedList 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.
limitstartcount_onlydeleted_onlyexclude_fieldsinclude_deletedGet a member
Get one member by id, with all custom fields, status, SMS status and bounce count.
member_idrequiredinclude_deletedFind a 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.
emailrequiredinclude_deletedGet a member's groups
List the groups one member belongs to.
limitstartmember_idrequiredGet a member's mailing history
The mailing history of one member: which mailings they were sent and what they did with them.
limitstartmember_idrequiredList member fields
List the custom member fields of the account (shortcut names, display names, types).
limitstartinclude_deletedGet an import
Status and results of one bulk member import (by import id), or, without an id, the list of all imports of the account.
limitstartimport_idList 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.
limitstartis_scheduledmailing_typesinclude_archivedmailing_statusesGet a mailing
Get one mailing in full: content (HTML and plain text), recipients (groups, searches, segments), links, schedule, status.
mailing_idrequiredinclude_segment_namesinclude_subscription_namesList a mailing's members
List the individual members a mailing was sent to (not groups or searches). Paged: use next_start.
limitstartmailing_idrequiredAccount 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).
rangeinclude_deletedGet a mailing's response
Response summary of one mailing: recipients, sent, delivered, bounced, opened, clicked (unique and total), forwarded, opt-outs, sign-ups.
mailing_idrequiredList a mailing's link clicks
The links of one mailing with their unique and total clicks.
limitstartmailing_idrequiredList 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.
kindrequiredlimitstartlink_idmember_idmailing_idrequireddelivery_typeList saved searches
List the saved searches (dynamic segments) of the account, with their criteria.
limitstartinclude_deletedList a search's members
The members that currently match a saved search. Paged: use next_start.
limitstartsearch_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.
io.usefulapiOfficial publisher
Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.
io.usefulapiOfficial publisher
Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.
{ "mcpServers": { "emma": { "url": "https://emma.usefulapi.io/mcp" } }}