# EmailOctopus — MCP server on mcp.ai
> Connect your EmailOctopus account and use 20 tools for email newsletters straight from your AI agent. Connect with your own API key. EmailOctopus is an email marketing platform founded in 2015, offering affordable and intuitive solutions for individuals and businesses to connect with their subscribers.

By: mcp.ai · official
Page: https://mcp.ai/emailoctopus

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_emailoctopus?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/emailoctopus/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/emailoctopus/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/emailoctopus/skill.md
Postman collection (v2.1): https://mcp.ai/emailoctopus/postman.json

## Tools
- emailoctopus_create_contact(tags?: string[], fields?: object, status?: string, list_id: string, email_address: string) — This tool creates a new contact in EmailOctopus. The tool will add a contact to a specified list with the provided information.
- emailoctopus_create_field(tag: string, type: string, label: string, list_id: string, fallback?: string) — Tool to create a new custom field on an EmailOctopus mailing list. Use when you need to add additional data fields beyond the default Email, First Name, and Last Name fields.
- emailoctopus_create_list(name: string) — Creates a new mailing list in EmailOctopus for organizing and managing email contacts. The list is created with default fields (Email address, First name, Last name) and can be used to add contacts, s
- emailoctopus_create_tag(tag: string, list_id: string) — Tool to create a new tag on an EmailOctopus mailing list. Use when you need to add a new tag for contact segmentation and filtering purposes.
- emailoctopus_delete_contact(list_id: string, contact_id: string) — Permanently deletes a contact from a specified EmailOctopus list. This action is irreversible - once deleted, the contact and all associated data will be removed from the list. Use this for list manag
- emailoctopus_delete_field(tag: string, list_id: string) — Permanently deletes a custom field from a specified EmailOctopus list. This action is irreversible - once deleted, the field and all associated data will be removed from the list. Use this for list cu
- emailoctopus_delete_list(list_id: string) — This tool allows you to delete an existing mailing list from your EmailOctopus account. Once a list is deleted, it cannot be recovered, and all contacts within the list will be permanently removed. No
- emailoctopus_delete_tag(tag: string, list_id: string) — Tool to delete a tag from a mailing list in EmailOctopus. Use when you need to remove an existing tag that is no longer needed for contact organization or segmentation.
- emailoctopus_get_all_lists(limit?: integer, starting_after?: string) — This tool retrieves all the mailing lists associated with the EmailOctopus account.
- emailoctopus_get_contact(list_id: string, contact_id: string) — Tool to retrieve details of a specific contact from an EmailOctopus list. Use when you need to fetch contact information including email, fields, tags, and subscription status.
- emailoctopus_get_list(list_id: string) — Retrieves details of a specific mailing list by ID. Use when you need to fetch list information, including its name, fields, tags, contact counts, and opt-in settings.
- emailoctopus_get_recent_campaigns(limit?: integer, starting_after?: string) — This tool retrieves a list of recent campaigns from the EmailOctopus account.
- emailoctopus_list_contacts(tag?: string, limit?: integer, status?: string, list_id: string, created_at_gte?: string, created_at_lte?: string, starting_after?: string, last_updated_at_gte?: string, last_updated_at_lte?: string) — Tool to retrieve contacts from an EmailOctopus list. Returns a paginated list of contacts with optional filtering by tag, status, and date ranges.
- emailoctopus_list_tags(limit?: integer, list_id: string, starting_after?: string) — Tool to retrieve all tags from a mailing list. Use when you need to see what tags are available on a specific list for contact segmentation.
- emailoctopus_unsubscribe_contact(list_id: string, contact_id: string) — Unsubscribes a contact from an EmailOctopus mailing list. This tool updates the contact's subscription status to 'unsubscribed', which stops them from receiving future emails from the specified list. 
- emailoctopus_update_contacts_batch(list_id: string, contacts: object[]) — Tool to update multiple contacts in an EmailOctopus list in a single batch operation. Use when you need to efficiently update multiple contacts at once with changes to their email, fields, status, or 
- emailoctopus_update_field(tag: string, type: string, label: string, list_id: string, fallback?: string, current_tag: string) — Updates an existing custom field on an EmailOctopus list including its label, tag, type, and fallback value. Use this action to modify field properties or rename field tags. Note that changing the tag
- emailoctopus_update_list(name: string, list_id: string) — Tool to update an existing mailing list's name in EmailOctopus. Use when you need to rename a list.
- emailoctopus_update_tag(tag: string, list_id: string, new_tag: string) — Tool to update an existing tag on a mailing list. Use when you need to rename a tag.
- emailoctopus_upsert_contact(tags?: object, fields?: object, status?: string, list_id: string, email_address: string) — Tool to create or update a contact in EmailOctopus. If the contact does not exist, it will be created. If the contact already exists, it will be updated. Use when you need to ensure a contact exists w

## Example prompts
- "What can I do in EmailOctopus?"
- "Show me a summary of my EmailOctopus account"

## Links
Docs: https://mcp.ai/docs/mcps/emailoctopus
Website: https://mcp.ai/mcps/emailoctopus