# EmailOctopus MCP by usefulapi

> EmailOctopus MCP by usefulapi is a freemium MCP server for marketing and seo. Hosted MCP server to manage EmailOctopus lists, contacts and campaign reports from AI. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/emailoctopus/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/emailoctopus
- **MCP Registry name:** io.usefulapi/emailoctopus
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The server gives Claude, ChatGPT, Cursor and other MCP clients direct access to an EmailOctopus account. Once connected, an assistant can look up lists and their contact counts, read contacts with their tags and status, and pull campaign reports covering sent, opened, clicked, bounced and unsubscribed figures. A per-link click report shows which URLs in a campaign drew the most clicks.

Access is handled through OAuth: the login page asks for an EmailOctopus API key, and the server calls the EmailOctopus API on the user's behalf. Five of the 17 tools can create or change data, including adding, updating or permanently deleting contacts and creating or renaming lists, so clients that ask for approval before a tool runs are the safer choice for those actions.

The server suits newsletter owners and email marketers who want to check campaign results or manage subscribers through a chat assistant instead of the EmailOctopus dashboard. It is an independent service from usefulapi and is not affiliated with EmailOctopus.

## Features

- **Campaign performance reports:** Returns sent, opened, clicked, bounced, unsubscribed and complained counts for a campaign.
- **Per-link click breakdown:** Ranks the links in a campaign by how many clicks each received.
- **List and contact overview:** Lists audiences with contact counts by status and reads contacts with their fields and tags.
- **Subscriber management:** Adds, updates or deletes contacts in a list, with the delete action marked as irreversible.
- **List creation and renaming:** Creates new lists and renames existing ones without opening the dashboard.
- **Usage metering and plan changes:** Reports tool-call usage and handles upgrading or cancelling a paid plan through the AI client.

## Good for

- Compare open and click rates across recent newsletter campaigns
- Check which article links readers clicked most in the last send
- Count subscribers on each list before planning a send
- Add a new signup to a newsletter list from a chat prompt
- Set up a new audience list for an upcoming campaign

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `emailoctopus_list_lists`: List all lists in the account. Returns {data:[...],paging:{...}} — each list's id, name, contact counts by status, and created_at. Paginate with `limit` (max 100) and `starting_after` (cursor from the previous page). EmailOctopus: GET /lists.
- `emailoctopus_get_list`: Get a single list by its id. Returns the list's full state — name, contact counts by status, and created_at. EmailOctopus: GET /lists/{list_id}.
- `emailoctopus_list_contacts`: List the contacts in a list. Returns {data:[...],paging:{...}} — each contact's id, email_address, fields, tags, status, and created_at. Paginate with `limit` (max 100) and `starting_after`. EmailOctopus: GET /lists/{list_id}/contacts.
- `emailoctopus_get_contact`: Get a single contact in a list. Returns email_address, fields, tags, status, and created_at. `contact_id` is the MD5 hash of the lowercased email address, or the `id` returned by emailoctopus_list_contacts. EmailOctopus: GET /lists/{list_id}/contacts/{contact_id}.
- `emailoctopus_list_campaigns`: List all campaigns in the account. Returns {data:[...],paging:{...}} — each campaign's id, name, status, subject, and created_at. Paginate with `limit` (max 100) and `starting_after`. EmailOctopus: GET /campaigns.
- `emailoctopus_get_campaign`: Get a single campaign by its id. Returns the campaign's full state — name, status, subject, from, content, and created_at. EmailOctopus: GET /campaigns/{campaign_id}.
- `emailoctopus_get_campaign_report`: Get a campaign's aggregate performance report — sent, opened, clicked, bounced, unsubscribed, complained, and related counts. EmailOctopus: GET /campaigns/{campaign_id}/reports/summary.
- `emailoctopus_get_campaign_links_report`: Get a campaign's per-link click report — for each link in the campaign, the URL and its click counts. EmailOctopus: GET /campaigns/{campaign_id}/reports/links.
- `emailoctopus_create_list`: CREATES a new list — this MODIFIES live data. Provide a `name`. EmailOctopus: POST /lists. Returns the created list.
- `emailoctopus_update_list`: UPDATES an existing list by id — this MODIFIES live data. Sets the list's `name`. EmailOctopus: PUT /lists/{list_id}. Returns the updated list.
- `emailoctopus_create_contact`: CREATES a new contact in a list — this MODIFIES live data (adds a subscriber). `email_address` is required; optionally set `fields` (keyed by field tag), `tags`, and `status`. EmailOctopus: POST /lists/{list_id}/contacts. Returns the created contact.
- `emailoctopus_update_contact`: UPDATES an existing contact in a list — this MODIFIES live data. Send only the fields you want to change (email_address, fields, tags, status). `contact_id` is the MD5 hash of the lowercased email address, or the id from list_contacts. EmailOctopus: PUT /lists/{list_id}/contacts/{contact_id}. Returns the updated contact.
- `emailoctopus_delete_contact`: PERMANENTLY REMOVES a contact from a list — this MODIFIES live data and cannot be undone. `contact_id` is the MD5 hash of the lowercased email address, or the id from list_contacts. EmailOctopus: DELETE /lists/{list_id}/contacts/{contact_id}.

## FAQ

### Is this an official EmailOctopus product?

No. usefulapi is an independent service and is not affiliated with or endorsed by EmailOctopus.

### Do I need to put my API key in the client config?

No. Add only the server URL. The server uses OAuth, and the login page asks for your EmailOctopus API key. The README and setup page advise removing any Authorization header from the config.

### Can the AI change my EmailOctopus data?

Yes, five tools can create or modify data, including deleting a contact, which cannot be undone. Most MCP clients ask for approval before a tool call runs.

### What does it cost?

The free plan allows 50 tool calls a month. Pro costs $9 per month or $90 per year for 10,000 calls, and Pro+ costs $39 per month or $390 per year for 100,000 calls. Each subscription covers this server only.

### Is EmailOctopus MCP by usefulapi free?

EmailOctopus MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add EmailOctopus MCP by usefulapi to Claude Code?

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

### What are the best alternatives to EmailOctopus MCP by usefulapi?

The closest alternatives to EmailOctopus MCP by usefulapi are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Snapchat Ads MCP Server, MCP and Red Center Studio free tools.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Snapchat Ads MCP Server](https://ai-powered.com/mcp/snapchat-ads-mcp-server): Snapchat Ads MCP Server is an open-source MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

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