Emma MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.9.4更新于 Nov 7, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行沟通与协作数据与分析商业与电商

概览

AI 生成的概览

以只读方式访问 Emma 邮件营销账户:受众、分组、成员、邮件活动及活动响应数据。

可以做什么
  • 列出并查看分组、成员和自定义字段,包括按邮箱查找成员及其所属分组
  • 查看邮件活动的内容、收件人、排期、状态以及单个成员的发送记录
  • 读取活动效果:账户按月汇总、单次活动响应、链接点击和成员级活动明细
  • 列出已保存的搜索(动态分组)及当前匹配的成员
  • 查看批量导入的状态与结果
  • 查询用量额度、提交功能请求或管理 Pro 订阅
适用场景
适合让助手回答关于 Emma 受众或活动效果的问题,例如某人在哪些分组、某个邮箱是否已订阅、上月邮件活动表现如何,而无需修改联系人数据或发送邮件。
运行要求
远程 MCP 端点,仅需在客户端配置中填写 URL,不要添加 API 密钥或 Authorization 头。登录使用 OAuth,登录页会要求填写 Emma 账户凭据。免费额度为每月 50 次工具调用,付费方案可提高上限。
安装前请注意
服务器会读取你的 Emma 受众数据,包括成员邮箱地址和互动历史,并经由第三方托管服务传输。订阅相关工具可能发起 Stripe 付费结账或取消 Pro;取消后服务持续到已付费周期结束,当期不退款。说明中还提到一个会记录请求的功能请求工具。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Emma MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Femma/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Emma MCP by usefulapi

Connect at https://emma.usefulapi.io/mcp.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://emma.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http emma https://emma.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "emma": {      "url": "https://emma.usefulapi.io/mcp"    }  }}

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.

Tools

ToolTypeWhat it does
emma_list_groupsreadList groups
emma_get_groupreadGet a group
emma_list_group_membersreadList group members
emma_list_membersreadList members
emma_get_memberreadGet a member
emma_find_member_by_emailreadFind a member by email
emma_get_member_groupsreadGet a member's groups
emma_get_member_mailingsreadGet a member's mailing history
emma_list_fieldsreadList member fields
emma_get_importreadGet an import
emma_list_mailingsreadList mailings
emma_get_mailingreadGet a mailing
emma_list_mailing_membersreadList a mailing's members
emma_get_response_summaryreadAccount response summary
emma_get_mailing_responsereadGet a mailing's response
emma_list_mailing_linksreadList a mailing's link clicks
emma_list_mailing_activityreadList mailing activity
emma_list_searchesreadList saved searches
emma_get_search_membersreadList a search's members
emma_usage_statusmetaUsage status (free-tier meter)
emma_request_featuremetaRequest a missing feature
emma_upgrademetaUpgrade to Pro or Pro+
emma_cancel_subscriptionmetaCancel the Pro subscription

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.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per connected account)$9/mo or $90/yr (2 months free)10,000 tool calls / month

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].

License

来源:servers/emma/README.md,提交 4046075

工具

19

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_types

emma_get_group

Get a group

Get one member group with its member counts (active, opted-out, error).

输入参数group_id必填

emma_list_group_members

List group members

List the members of one group (email, status, custom fields). Paged: use next_start for more.

输入参数limitstartgroup_id必填include_deleted

emma_list_members

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.

输入参数limitstartcount_onlydeleted_onlyexclude_fieldsinclude_deleted

emma_get_member

Get a member

Get one member by id, with all custom fields, status, SMS status and bounce count.

输入参数member_id必填include_deleted

emma_find_member_by_email

Find 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.

输入参数email必填include_deleted

emma_get_member_groups

Get a member's groups

List the groups one member belongs to.

输入参数limitstartmember_id必填

emma_get_member_mailings

Get a member's mailing history

The mailing history of one member: which mailings they were sent and what they did with them.

输入参数limitstartmember_id必填

emma_list_fields

List member fields

List the custom member fields of the account (shortcut names, display names, types).

输入参数limitstartinclude_deleted

emma_get_import

Get 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_id

emma_list_mailings

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.

输入参数limitstartis_scheduledmailing_typesinclude_archivedmailing_statuses

emma_get_mailing

Get a mailing

Get one mailing in full: content (HTML and plain text), recipients (groups, searches, segments), links, schedule, status.

输入参数mailing_id必填include_segment_namesinclude_subscription_names

emma_list_mailing_members

List a mailing's members

List the individual members a mailing was sent to (not groups or searches). Paged: use next_start.

输入参数limitstartmailing_id必填

emma_get_response_summary

Account 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_deleted

emma_get_mailing_response

Get a mailing's response

Response summary of one mailing: recipients, sent, delivered, bounced, opened, clicked (unique and total), forwarded, opt-outs, sign-ups.

输入参数mailing_id必填

emma_list_mailing_activity

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.

输入参数kind必填limitstartlink_idmember_idmailing_id必填delivery_type

emma_list_searches

List saved searches

List the saved searches (dynamic segments) of the account, with their criteria.

输入参数limitstartinclude_deleted

emma_get_search_members

List a search's members

The members that currently match a saved search. Paged: use next_start.

输入参数limitstartsearch_id必填

版本历史

11
  1. v1.9.4最新Nov 7, 2026
  2. v1.8.3Nov 5, 2026
  3. v1.8.2Nov 5, 2026
  4. v1.8.1Nov 4, 2026
  5. v1.8.0Nov 3, 2026
  6. v1.7.1Nov 3, 2026
  7. v1.6.0Nov 1, 2026
  8. v1.4.0Oct 31, 2026
  9. v1.3.0Oct 31, 2026
  10. v1.2.2Oct 30, 2026
  11. v1.2.0Oct 30, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成