# Emma MCP by usefulapi

> Emma MCP by usefulapi is an MCP server. Read audiences, groups, mailings and campaign results without sending email or changing contacts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/emma/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/emma
- **MCP Registry name:** io.usefulapi/emma
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://emma.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "emma": {
      "url": "https://emma.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

---
Source: https://ai-powered.com/mcp/emma-mcp-by-usefulapi
