MCPサーバー

emailoctopus

io.usefulapi/emailoctopus

このMCPでできること

Manages EmailOctopus lists, contacts, campaigns, and campaign performance reports.

emailoctopus_create_contact
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id', 'email_address'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tags to apply to the contact, e.g. ["vip", "beta"].'}, 'fields': {'type': 'object', 'description': 'Custom field values, keyed by the list\'s field tag (e.g. {"FirstName": "Ada"}).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'status': {'enum': ['subscribed', 'pending', 'unsubscribed'], 'type': 'string', 'description': 'Subscription status: subscribed, pending, or unsubscribed.'}, 'list_id': {'type': 'string', 'description': "The list's id to add the contact to."}, 'email_address': {'type': 'string', 'description': "The contact's email address."}}}
emailoctopus_create_list
Create list
CREATES a new list — this MODIFIES live data. Provide a `name`. EmailOctopus: POST /lists. Returns the created list.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Human-readable name for the new list.'}}}
emailoctopus_delete_contact
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}.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id', 'contact_id'], 'properties': {'list_id': {'type': 'string', 'description': "The list's id."}, 'contact_id': {'type': 'string', 'description': "The contact's id to delete — the MD5 hash of the lowercased email address, or the id from list_contacts."}}}
emailoctopus_get_campaign
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}.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': "The campaign's id."}}}
emailoctopus_get_campaign_links_report
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': "The campaign's id."}}}
emailoctopus_get_campaign_report
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': "The campaign's id."}}}
emailoctopus_get_contact
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}.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id', 'contact_id'], 'properties': {'list_id': {'type': 'string', 'description': "The list's id."}, 'contact_id': {'type': 'string', 'description': "The contact's id — the MD5 hash of the lowercased email address, or the id from list_contacts."}}}
emailoctopus_get_list
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}.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id'], 'properties': {'list_id': {'type': 'string', 'description': "The list's id."}}}
emailoctopus_list_campaigns
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max campaigns to return (1..100).'}, 'starting_after': {'type': 'string', 'description': "Pagination cursor — the id to start after (from the previous page's paging)."}}}
emailoctopus_list_contacts
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max contacts to return (1..100).'}, 'list_id': {'type': 'string', 'description': "The list's id."}, 'starting_after': {'type': 'string', 'description': "Pagination cursor — the id to start after (from the previous page's paging)."}}}
emailoctopus_list_lists
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max lists to return (1..100).'}, 'starting_after': {'type': 'string', 'description': "Pagination cursor — the id to start after (from the previous page's paging)."}}}
emailoctopus_update_contact
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id', 'contact_id'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tags to apply to the contact, e.g. ["vip", "beta"].'}, 'fields': {'type': 'object', 'description': 'Custom field values, keyed by the list\'s field tag (e.g. {"FirstName": "Ada"}).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'status': {'enum': ['subscribed', 'pending', 'unsubscribed'], 'type': 'string', 'description': 'Subscription status: subscribed, pending, or unsubscribed.'}, 'list_id': {'type': 'string', 'description': "The list's id."}, 'contact_id': {'type': 'string', 'description': "The contact's id — the MD5 hash of the lowercased email address, or the id from list_contacts."}, 'email_address': {'type': 'string', 'description': "The contact's email address."}}}
emailoctopus_update_list
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list_id', 'name'], 'properties': {'name': {'type': 'string', 'description': 'The new name for the list.'}, 'list_id': {'type': 'string', 'description': "The list's id to update."}}}
変更
emailoctopus_delete_contact
2026年10月1日2:50
変更
emailoctopus_update_contact
2026年10月1日2:50
変更
emailoctopus_create_contact
2026年10月1日2:50
変更
emailoctopus_update_list
2026年10月1日2:50
変更
emailoctopus_create_list
2026年10月1日2:50
変更
emailoctopus_get_campaign_links_report
2026年10月1日2:50
変更
emailoctopus_get_campaign_report
2026年10月1日2:50
変更
emailoctopus_get_campaign
2026年10月1日2:50
変更
emailoctopus_list_campaigns
2026年10月1日2:50
変更
emailoctopus_get_contact
2026年10月1日2:50
変更
emailoctopus_list_contacts
2026年10月1日2:50
変更
emailoctopus_get_list
2026年10月1日2:50
変更
emailoctopus_list_lists
2026年10月1日2:50
追加
emailoctopus_delete_contact
2026年9月17日12:53
追加
emailoctopus_update_contact
2026年9月17日12:53
追加
emailoctopus_create_contact
2026年9月17日12:53
追加
emailoctopus_update_list
2026年9月17日12:53
追加
emailoctopus_create_list
2026年9月17日12:53
追加
emailoctopus_get_campaign_links_report
2026年9月17日12:53
追加
emailoctopus_get_campaign_report
2026年9月17日12:53
追加
emailoctopus_get_campaign
2026年9月17日12:53
追加
emailoctopus_list_campaigns
2026年9月17日12:53
追加
emailoctopus_get_contact
2026年9月17日12:53
追加
emailoctopus_list_contacts
2026年9月17日12:53
追加
emailoctopus_get_list
2026年9月17日12:53
追加
emailoctopus_list_lists
2026年9月17日12:53