Emailchef MCP by usefulapi is an MCP server published by io.usefulapi, hosted at emailchef.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 43 tools, including emailchef_get_account, emailchef_get_subscription, emailchef_list_senders, emailchef_list_timezones, emailchef_list_lists.
Read lists, contacts, campaign stats; add contacts; draft, schedule and send campaigns and SMS.
4,250 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Emailchef account this API key belongs to: id, email, language, status, subscriber total, bounces and complaints. GET /accounts/current.
No parameters.
{
"name": "emailchef_get_account",
"title": "Get account",
"description": "The Emailchef account this API key belongs to: id, email, language, status, subscriber total, bounces and complaints. GET /accounts/current.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The account's current Emailchef plan: plan name, plan expiry, contact and send limits, credits left, active/expired flags. Check this before a big send. GET /subscriptions/current.
No parameters.
{
"name": "emailchef_get_subscription",
"title": "Get subscription",
"description": "The account's current Emailchef plan: plan name, plan expiry, contact and send limits, credits left, active/expired flags. Check this before a big send. GET /subscriptions/current.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get subscription",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the sender identities (name, email, verification status, postal address). Campaigns and emails need a verified sender id. GET /senders.
No parameters.
{
"name": "emailchef_list_senders",
"title": "List senders",
"description": "List the sender identities (name, email, verification status, postal address). Campaigns and emails need a verified sender id. GET /senders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List senders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List Emailchef's timezones (id, name, fixed UTC offset). The id is required to schedule a campaign. GET /meta/timezones.
No parameters.
{
"name": "emailchef_list_timezones",
"title": "List timezones",
"description": "List Emailchef's timezones (id, name, fixed UTC offset). The id is required to schedule a campaign. GET /meta/timezones.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List timezones",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the contact lists with id, name, and counts of active, unsubscribed and bounced contacts and segments. Newest first by default. GET /lists.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| order | string | Sort direction (default desc). |
| offset | integer | Rows to skip (default 0). Pass the previous reply's next_offset. |
| order_by | string | Sort by creation date (default) or name. |
{
"name": "emailchef_list_lists",
"title": "List contact lists",
"description": "List the contact lists with id, name, and counts of active, unsubscribed and bounced contacts and segments. Newest first by default. GET /lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (default desc)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_offset."
},
"order_by": {
"enum": [
"created",
"name"
],
"type": "string",
"description": "Sort by creation date (default) or name."
}
}
},
"annotations": {
"title": "List contact lists",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One contact list: name, description, default sender, creation date. GET /lists/{list_id}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_list",
"title": "Get list",
"description": "One contact list: name, description, default sender, creation date. GET /lists/{list_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get list",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Daily growth of a list over a date range: total contacts per day and the daily delta. Omit the dates for the whole history. GET /lists/{list_id}/stats.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
| end_date | string | Last day, yyyy-mm-dd. |
| start_date | string | First day, yyyy-mm-dd. |
{
"name": "emailchef_get_list_stats",
"title": "Get list growth stats",
"description": "Daily growth of a list over a date range: total contacts per day and the daily delta. Omit the dates for the whole history. GET /lists/{list_id}/stats.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"end_date": {
"type": "string",
"description": "Last day, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"description": "First day, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Get list growth stats",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}How many contacts a list has by state: active, unsubscribed, bounced, reported. GET /lists/{list_id}/stats/count.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_list_contact_counts",
"title": "Get list contact counts",
"description": "How many contacts a list has by state: active, unsubscribed, bounced, reported. GET /lists/{list_id}/stats/count.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get list contact counts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a new, empty contact list. Returns the new list id. POST /lists.
| Parameter | Type | Description |
|---|---|---|
| name * | string | List name. |
| description | string | List description. |
{
"name": "emailchef_create_list",
"title": "Create list",
"description": "WRITE: create a new, empty contact list. Returns the new list id. POST /lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "List name."
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "List description."
}
}
},
"annotations": {
"title": "Create list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: rename a contact list and/or change its description. Only the fields you pass change. PUT /lists/{list_id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | New list name. |
| list_id * | any | Numeric id (as returned by the list tools). |
| description | string | New description. |
{
"name": "emailchef_update_list",
"title": "Update list",
"description": "WRITE: rename a contact list and/or change its description. Only the fields you pass change. PUT /lists/{list_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "New list name."
},
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "New description."
}
}
},
"annotations": {
"title": "Update list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}List the contacts of one list (id, email, name, added by, subscription date), optionally by state. GET /contacts?list_id=...
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| order | string | Sort direction (default desc). |
| offset | integer | Rows to skip (default 0). Pass the previous reply's next_offset. |
| status | string | Only contacts in this state (default: all). |
| list_id * | any | Numeric id (as returned by the list tools). |
| order_by | string | Sort field (default subscription date). |
{
"name": "emailchef_list_contacts",
"title": "List contacts",
"description": "List the contacts of one list (id, email, name, added by, subscription date), optionally by state. GET /contacts?list_id=...",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (default desc)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_offset."
},
"status": {
"enum": [
"ACTIVE",
"UNSUBSCRIBED",
"BOUNCED",
"REPORTED"
],
"type": "string",
"description": "Only contacts in this state (default: all)."
},
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"order_by": {
"enum": [
"email",
"name",
"added_by",
"subscribed",
"status"
],
"type": "string",
"description": "Sort field (default subscription date)."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One contact in one list: status, email, name, IP, how it was added, when, and its custom field values. GET /contacts/{contact_id}?list_id=...
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
| contact_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_contact",
"title": "Get contact",
"description": "One contact in one list: status, email, name, IP, how it was added, when, and its custom field values. GET /contacts/{contact_id}?list_id=...",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contact_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get contact",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: add a contact (email, name, custom fields) to a list. Only add people who agreed to receive email: an ACTIVE contact will receive the account's campaigns and automations. Returns the contact id and status. POST /contacts.
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| status | string | Initial state (default: the account's default, normally ACTIVE). |
| list_id * | any | Numeric id (as returned by the list tools). |
| last_name | string | |
| first_name | string | |
| custom_fields | object | Custom field values keyed by the field's place_holder (see emailchef_list_custom_fields): a string, or true/false for boolean fields. |
{
"name": "emailchef_create_contact",
"title": "Add contact to a list",
"description": "WRITE: add a contact (email, name, custom fields) to a list. Only add people who agreed to receive email: an ACTIVE contact will receive the account's campaigns and automations. Returns the contact id and status. POST /contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"status": {
"enum": [
"ACTIVE",
"UNSUBSCRIBED",
"BOUNCED",
"REPORTED"
],
"type": "string",
"description": "Initial state (default: the account's default, normally ACTIVE)."
},
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"last_name": {
"type": "string",
"maxLength": 200
},
"first_name": {
"type": "string",
"maxLength": 200
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's place_holder (see emailchef_list_custom_fields): a string, or true/false for boolean fields.",
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "boolean"
}
]
}
}
}
},
"annotations": {
"title": "Add contact to a list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: change a contact's name, state or custom fields in one list. Only the fields you pass change. Setting the status to ACTIVE re-subscribes someone: only do so with their consent. PUT /contacts/{contact_id}.
| Parameter | Type | Description |
|---|---|---|
| status | string | one of ["ACTIVE","UNSUBSCRIBED","BOUNCED","REPORTED"] |
| list_id * | any | Numeric id (as returned by the list tools). |
| last_name | string | |
| contact_id * | any | Numeric id (as returned by the list tools). |
| first_name | string | |
| custom_fields | object | Custom field values keyed by the field's place_holder (see emailchef_list_custom_fields): a string, or true/false for boolean fields. |
{
"name": "emailchef_update_contact",
"title": "Update contact",
"description": "WRITE: change a contact's name, state or custom fields in one list. Only the fields you pass change. Setting the status to ACTIVE re-subscribes someone: only do so with their consent. PUT /contacts/{contact_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contact_id"
],
"properties": {
"status": {
"enum": [
"ACTIVE",
"UNSUBSCRIBED",
"BOUNCED",
"REPORTED"
],
"type": "string"
},
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"last_name": {
"type": "string",
"maxLength": 200
},
"contact_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"first_name": {
"type": "string",
"maxLength": 200
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's place_holder (see emailchef_list_custom_fields): a string, or true/false for boolean fields.",
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "boolean"
}
]
}
}
}
},
"annotations": {
"title": "Update contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: unsubscribe one contact from one list (it stops receiving that list's email). POST /lists/{list_id}/unsubscribe?contact_id=...
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
| contact_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_unsubscribe_contact",
"title": "Unsubscribe contact",
"description": "WRITE: unsubscribe one contact from one list (it stops receiving that list's email). POST /lists/{list_id}/unsubscribe?contact_id=...",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contact_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Unsubscribe contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: bulk-add or update up to 500 contacts in a list in one call (an existing email is updated). Each contact is an object keyed by field placeholder, e.g. {"email":"a@b.com","firstname":"Ada"}: get the placeholders from emailchef_list_predefined_fields and emailchef_list_custom_fields. Import only people who agreed to receive email. Runs in the background: poll emailchef_get_import_task with the returned id. POST /lists/{list_id}/import.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
| contacts * | array | Contacts to import, each keyed by placeholder. |
{
"name": "emailchef_import_contacts",
"title": "Import contacts",
"description": "WRITE: bulk-add or update up to 500 contacts in a list in one call (an existing email is updated). Each contact is an object keyed by field placeholder, e.g. {\"email\":\"a@b.com\",\"firstname\":\"Ada\"}: get the placeholders from emailchef_list_predefined_fields and emailchef_list_custom_fields. Import only people who agreed to receive email. Runs in the background: poll emailchef_get_import_task with the returned id. POST /lists/{list_id}/import.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contacts"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"contacts": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"type": "string",
"maxLength": 2000
}
},
"maxItems": 500,
"minItems": 1,
"description": "Contacts to import, each keyed by placeholder."
}
}
},
"annotations": {
"title": "Import contacts",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List contact import tasks: list, status (DISPATCHED, COMPLETE, FAILED), progress, imported/updated/failed counts. GET /importtasks.
No parameters.
{
"name": "emailchef_list_import_tasks",
"title": "List import tasks",
"description": "List contact import tasks: list, status (DISPATCHED, COMPLETE, FAILED), progress, imported/updated/failed counts. GET /importtasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List import tasks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One import task: status, progress, imported/updated/failed counts and any error message. GET /importtasks/{task_id}.
| Parameter | Type | Description |
|---|---|---|
| task_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_import_task",
"title": "Get import task",
"description": "One import task: status, progress, imported/updated/failed counts and any error message. GET /importtasks/{task_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"task_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get import task",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The built-in contact fields (email, first name, ...) with their placeholders. GET /predefinedfields.
No parameters.
{
"name": "emailchef_list_predefined_fields",
"title": "List predefined fields",
"description": "The built-in contact fields (email, first name, ...) with their placeholders. GET /predefinedfields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List predefined fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The custom contact fields of a list: name, data type, placeholder (the key used when writing contacts), options. GET /lists/{list_id}/customfields.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_list_custom_fields",
"title": "List custom fields",
"description": "The custom contact fields of a list: name, data type, placeholder (the key used when writing contacts), options. GET /lists/{list_id}/customfields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "List custom fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the saved segments of a list with how many contacts match each. GET /lists/{list_id}/segments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Rows to skip (default 0). Pass the previous reply's next_offset. |
| list_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_list_segments",
"title": "List segments",
"description": "List the saved segments of a list with how many contacts match each. GET /lists/{list_id}/segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_offset."
},
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "List segments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One segment with its logic and condition groups. GET /lists/{list_id}/segments/{segment_id}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | Numeric id (as returned by the list tools). |
| segment_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_segment",
"title": "Get segment",
"description": "One segment with its logic and condition groups. GET /lists/{list_id}/segments/{segment_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"segment_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"segment_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get segment",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the account's blocklist (emails that never receive email): address and reason (MANUAL, UNSUBSCRIBED, COMPLAINT). GET /blockings.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Rows to skip (default 0). Pass the previous reply's next_offset. |
| search | string | Only addresses containing this text. |
{
"name": "emailchef_list_blocked",
"title": "List blocked emails",
"description": "List the account's blocklist (emails that never receive email): address and reason (MANUAL, UNSUBSCRIBED, COMPLAINT). GET /blockings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_offset."
},
"search": {
"type": "string",
"maxLength": 200,
"description": "Only addresses containing this text."
}
}
},
"annotations": {
"title": "List blocked emails",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: add up to 100 addresses to the account blocklist so they never receive email from any list. Reversible with emailchef_unblock_email. POST /blockings?type=MANUAL.
| Parameter | Type | Description |
|---|---|---|
| emails * | array | Addresses to block. |
{
"name": "emailchef_block_emails",
"title": "Block emails",
"description": "WRITE: add up to 100 addresses to the account blocklist so they never receive email from any list. Reversible with emailchef_unblock_email. POST /blockings?type=MANUAL.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"emails"
],
"properties": {
"emails": {
"type": "array",
"items": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"maxItems": 100,
"minItems": 1,
"description": "Addresses to block."
}
}
},
"annotations": {
"title": "Block emails",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: remove one address from the account blocklist so it can receive email again. Only do this for an address whose owner asked for it. DELETE /blockings/{email}.
| Parameter | Type | Description |
|---|---|---|
| email * | string |
{
"name": "emailchef_unblock_email",
"title": "Unblock email",
"description": "WRITE: remove one address from the account blocklist so it can receive email again. Only do this for an address whose owner asked for it. DELETE /blockings/{email}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
}
}
},
"annotations": {
"title": "Unblock email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}How many campaigns the account has by state: drafts, sent, scheduled, archived, failed. GET /campaigns/count.
No parameters.
{
"name": "emailchef_get_campaign_counts",
"title": "Get campaign counts",
"description": "How many campaigns the account has by state: drafts, sent, scheduled, archived, failed. GET /campaigns/count.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get campaign counts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List email campaigns with state, recipients, delivered, unique opens and unique clicks. Without a status filter Emailchef returns only SENT and ARCHIVED campaigns; pass a status to see DRAFT, SCHEDULED, SENDING or FAILED ones. GET /campaigns.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| order | string | Sort direction (default desc). |
| offset | integer | Rows to skip (default 0). Pass the previous reply's next_offset. |
| search | string | Only campaigns whose name contains this text. |
| status | string | Only campaigns in this state (default: SENT and ARCHIVED). |
| order_by | string | Sort by date (default) or name. |
{
"name": "emailchef_list_campaigns",
"title": "List campaigns",
"description": "List email campaigns with state, recipients, delivered, unique opens and unique clicks. Without a status filter Emailchef returns only SENT and ARCHIVED campaigns; pass a status to see DRAFT, SCHEDULED, SENDING or FAILED ones. GET /campaigns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (default desc)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_offset."
},
"search": {
"type": "string",
"maxLength": 200,
"description": "Only campaigns whose name contains this text."
},
"status": {
"enum": [
"DRAFT",
"SCHEDULED",
"SENDING",
"SENT",
"ARCHIVED",
"FAILED"
],
"type": "string",
"description": "Only campaigns in this state (default: SENT and ARCHIVED)."
},
"order_by": {
"enum": [
"time",
"name"
],
"type": "string",
"description": "Sort by date (default) or name."
}
}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One campaign: name, subject, HTML and text body, sender, reply-to, state, schedule, recipient lists/segments and cached sent/open/click counts. GET /campaigns/{id}.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_campaign",
"title": "Get campaign",
"description": "One campaign: name, subject, HTML and text body, sender, reply-to, state, schedule, recipient lists/segments and cached sent/open/click counts. GET /campaigns/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get campaign",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The links contained in a campaign (id, name, URL). GET /newsletters/{id}/links.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_get_campaign_links",
"title": "Get campaign links",
"description": "The links contained in a campaign (id, name, URL). GET /newsletters/{id}/links.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get campaign links",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Per-contact engagement for a sent campaign: who opened, clicked, was delivered, did not open, unsubscribed, complained, or was sent to, with counts and first/last event time. Pick exactly one event. GET /newsletters/{id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| event * | string | Which engagement slice to list. |
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Rows to skip (default 0). Pass the previous reply's next_offset. |
| search | string | Only contacts whose email or name contains this text. |
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_list_campaign_engagement",
"title": "List campaign engagement",
"description": "Per-contact engagement for a sent campaign: who opened, clicked, was delivered, did not open, unsubscribed, complained, or was sent to, with counts and first/last event time. Pick exactly one event. GET /newsletters/{id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id",
"event"
],
"properties": {
"event": {
"enum": [
"open",
"click",
"deliver",
"unopen",
"unsubscribe",
"report",
"sent",
"scheduled"
],
"type": "string",
"description": "Which engagement slice to list."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_offset."
},
"search": {
"type": "string",
"maxLength": 200,
"description": "Only contacts whose email or name contains this text."
},
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "List campaign engagement",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a new campaign as a DRAFT (nothing is sent). Needs a verified sender (emailchef_list_senders) and at least one list. To be sendable the HTML body must contain the CAN-SPAM placeholders [[account:business]], [[account:address_1]], [[account:city]], [[account:postal_code]], [[account:country]] and an unsubscribe link <a href="[[unsubscribe_link]]">, otherwise the send ends FAILED. Schedule or send it afterwards. POST /newsletters.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Campaign name (must be unique in the account). |
| subject * | string | Email subject. |
| list_ids * | array | Lists to send to. |
| html_body | string | HTML body (include the CAN-SPAM placeholders and unsubscribe link). |
| sender_id * | any | A verified sender id from emailchef_list_senders. |
| text_body | string | Plain-text body. |
| segment_id | any | Optional segment of the FIRST list to narrow the audience. |
| reply_to_id | any | Sender id used for replies. |
WRITE: copy an existing campaign into a new DRAFT (nothing is sent). A SENT campaign cannot be cloned (Emailchef answers HTTP 500). Returns the new campaign id. POST /newsletters?clone=1.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | The campaign to copy. |
{
"name": "emailchef_clone_campaign",
"title": "Clone campaign",
"description": "WRITE: copy an existing campaign into a new DRAFT (nothing is sent). A SENT campaign cannot be cloned (Emailchef answers HTTP 500). Returns the new campaign id. POST /newsletters?clone=1.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "The campaign to copy."
}
}
},
"annotations": {
"title": "Clone campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: change a DRAFT campaign's name, subject, body, sender, reply-to or recipient lists. Only the fields you pass change: the tool reads the campaign first and sends the complete record back, because Emailchef blanks any omitted field. Refuses a campaign that is not a DRAFT. PUT /newsletters/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| subject | string | |
| list_ids | array | Replace the recipient lists (any segment is dropped unless segment_id is also passed). |
| html_body | string | |
| sender_id | any | Numeric id (as returned by the list tools). |
| text_body | string | |
| segment_id | any | Segment of the first list (only with list_ids). |
| campaign_id * | any | Numeric id (as returned by the list tools). |
| reply_to_id | any | Numeric id (as returned by the list tools). |
WRITE: email ONE test copy of a campaign to a single address. The campaign state does not change. The sender must be verified. PUT /campaigns/{id}/sendtest.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Where to send the test copy. |
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_send_test_campaign",
"title": "Send campaign test email",
"description": "WRITE: email ONE test copy of a campaign to a single address. The campaign state does not change. The sender must be verified. PUT /campaigns/{id}/sendtest.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254,
"description": "Where to send the test copy."
},
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Send campaign test email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE, SENDS EMAIL TO CUSTOMERS LATER: schedule a DRAFT campaign to go out to all its recipients at a date and time. Emailchef timezones are fixed offsets without daylight saving: pick the id (emailchef_list_timezones) whose offset matches the send date. Undo before it starts with emailchef_unschedule_campaign. PUT /campaigns/{id}/schedule.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | Numeric id (as returned by the list tools). |
| timezone_id * | any | Timezone id from emailchef_list_timezones. |
| scheduled_time * | string | Local send time in the chosen timezone, YYYY-MM-DD HH:MM:SS (no UTC offset or Z). |
{
"name": "emailchef_schedule_campaign",
"title": "Schedule campaign",
"description": "WRITE, SENDS EMAIL TO CUSTOMERS LATER: schedule a DRAFT campaign to go out to all its recipients at a date and time. Emailchef timezones are fixed offsets without daylight saving: pick the id (emailchef_list_timezones) whose offset matches the send date. Undo before it starts with emailchef_unschedule_campaign. PUT /campaigns/{id}/schedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id",
"scheduled_time",
"timezone_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"timezone_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Timezone id from emailchef_list_timezones."
},
"scheduled_time": {
"type": "string",
"description": "Local send time in the chosen timezone, YYYY-MM-DD HH:MM:SS (no UTC offset or Z)."
}
}
},
"annotations": {
"title": "Schedule campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: cancel the schedule of a SCHEDULED campaign and bring it back to DRAFT. PUT /campaigns/{id}/unschedule.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_unschedule_campaign",
"title": "Unschedule campaign",
"description": "WRITE: cancel the schedule of a SCHEDULED campaign and bring it back to DRAFT. PUT /campaigns/{id}/unschedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Unschedule campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE, SENDS EMAIL TO CUSTOMERS NOW AND CANNOT BE UNDONE: start sending a DRAFT (or FAILED) campaign immediately to ALL its recipients and use up plan sends. Check the recipients (emailchef_get_campaign), the sender and the subscription first, ideally after emailchef_send_test_campaign, and send only with the user's explicit go-ahead (confirm must be true). Queued asynchronously: poll emailchef_get_campaign for the final state. PUT /campaigns/{id}/send.
| Parameter | Type | Description |
|---|---|---|
| confirm * | boolean | Must be true: the user explicitly approved sending this campaign now. |
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_send_campaign",
"title": "Send campaign now",
"description": "WRITE, SENDS EMAIL TO CUSTOMERS NOW AND CANNOT BE UNDONE: start sending a DRAFT (or FAILED) campaign immediately to ALL its recipients and use up plan sends. Check the recipients (emailchef_get_campaign), the sender and the subscription first, ideally after emailchef_send_test_campaign, and send only with the user's explicit go-ahead (confirm must be true). Queued asynchronously: poll emailchef_get_campaign for the final state. PUT /campaigns/{id}/send.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id",
"confirm"
],
"properties": {
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: the user explicitly approved sending this campaign now."
},
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Send campaign now",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: archive a campaign (hidden from the default list; statistics are kept). Reversible with emailchef_unarchive_campaign. PUT /campaigns/{id}/archivecampaign.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_archive_campaign",
"title": "Archive campaign",
"description": "WRITE: archive a campaign (hidden from the default list; statistics are kept). Reversible with emailchef_unarchive_campaign. PUT /campaigns/{id}/archivecampaign.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Archive campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: restore an archived campaign. PUT /campaigns/{id}/unarchivecampaign.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | any | Numeric id (as returned by the list tools). |
{
"name": "emailchef_unarchive_campaign",
"title": "Restore archived campaign",
"description": "WRITE: restore an archived campaign. PUT /campaigns/{id}/unarchivecampaign.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Restore archived campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE, SENDS AN EMAIL NOW AND CANNOT BE UNDONE: send a single email to one recipient from a verified sender and use up plan sends. Pass text_body and/or html_body. The recipient does not need to be a contact. Send only with the user's explicit go-ahead (confirm must be true). POST /sendmail.
| Parameter | Type | Description |
|---|---|---|
| confirm * | boolean | Must be true: the user explicitly approved sending this email now. |
| subject * | string | |
| to_name | string | |
| reply_to | string | |
| to_email * | string | |
| html_body | string | |
| sender_id * | any | A verified sender id from emailchef_list_senders. |
| text_body | string |
{
"name": "emailchef_send_email",
"title": "Send one email",
"description": "WRITE, SENDS AN EMAIL NOW AND CANNOT BE UNDONE: send a single email to one recipient from a verified sender and use up plan sends. Pass text_body and/or html_body. The recipient does not need to be a contact. Send only with the user's explicit go-ahead (confirm must be true). POST /sendmail.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sender_id",
"to_email",
"subject",
"confirm"
],
"properties": {
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: the user explicitly approved sending this email now."
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1
},
"to_name": {
"type": "string",
"maxLength": 200
},
"reply_to": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"to_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"html_body": {
"type": "string",
"maxLength": 2000000
},
"sender_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "A verified sender id from emailchef_list_senders."
},
"text_body": {
"type": "string",
"maxLength": 500000
}
}
},
"annotations": {
"title": "Send one email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}The account's SMS credit balance and currency. GET /sms/balance.
No parameters.
{
"name": "emailchef_get_sms_balance",
"title": "Get SMS balance",
"description": "The account's SMS credit balance and currency. GET /sms/balance.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get SMS balance",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Delivery status of one sent SMS by message id: recipient, text, sent/done time, parts, price, state and error. GET /sms/status/{messageId}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | Message id returned by emailchef_send_sms. |
{
"name": "emailchef_get_sms_status",
"title": "Get SMS status",
"description": "Delivery status of one sent SMS by message id: recipient, text, sent/done time, parts, price, state and error. GET /sms/status/{messageId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Message id returned by emailchef_send_sms."
}
}
},
"annotations": {
"title": "Get SMS status",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE, SENDS TEXT MESSAGES NOW, COSTS SMS CREDIT AND CANNOT BE UNDONE: send an SMS to 1-50 phone numbers in international format (e.g. +393331234567). Check emailchef_get_sms_balance first and send only with the user's explicit go-ahead (confirm must be true). Returns a message id per recipient and the remaining balance. POST /sms/send.
| Parameter | Type | Description |
|---|---|---|
| to * | array | Recipient phone numbers. |
| from | string | Sender name or number (default: the account's). |
| text * | string | The message text. |
| confirm * | boolean | Must be true: the user explicitly approved sending these SMS now. |
{
"name": "emailchef_send_sms",
"title": "Send SMS",
"description": "WRITE, SENDS TEXT MESSAGES NOW, COSTS SMS CREDIT AND CANNOT BE UNDONE: send an SMS to 1-50 phone numbers in international format (e.g. +393331234567). Check emailchef_get_sms_balance first and send only with the user's explicit go-ahead (confirm must be true). Returns a message id per recipient and the remaining balance. POST /sms/send.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to",
"text",
"confirm"
],
"properties": {
"to": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\+?[0-9]{6,15}$"
},
"maxItems": 50,
"minItems": 1,
"description": "Recipient phone numbers."
},
"from": {
"type": "string",
"maxLength": 15,
"minLength": 1,
"description": "Sender name or number (default: the account's)."
},
"text": {
"type": "string",
"maxLength": 1600,
"minLength": 1,
"description": "The message text."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: the user explicitly approved sending these SMS now."
}
}
},
"annotations": {
"title": "Send SMS",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tools for Emailchef, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many active contacts are in each of my Emailchef lists?"; "Which campaigns did I send last month and how many people opened each?"; "Add anna@example.com to my Newsletter list.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Emailchef data. Free plan: 50 tool calls per month. Run emailchef_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run emailchef_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run emailchef_upgrade without a plan: it returns both plans, each with a payment link for the user to open. emailchef_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "emailchef_create_campaign",
"title": "Create campaign (draft)",
"description": "WRITE: create a new campaign as a DRAFT (nothing is sent). Needs a verified sender (emailchef_list_senders) and at least one list. To be sendable the HTML body must contain the CAN-SPAM placeholders [[account:business]], [[account:address_1]], [[account:city]], [[account:postal_code]], [[account:country]] and an unsubscribe link <a href=\"[[unsubscribe_link]]\">, otherwise the send ends FAILED. Schedule or send it afterwards. POST /newsletters.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"subject",
"sender_id",
"list_ids"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Campaign name (must be unique in the account)."
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1,
"description": "Email subject."
},
"list_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"maxItems": 20,
"minItems": 1,
"description": "Lists to send to."
},
"html_body": {
"type": "string",
"maxLength": 2000000,
"description": "HTML body (include the CAN-SPAM placeholders and unsubscribe link)."
},
"sender_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "A verified sender id from emailchef_list_senders."
},
"text_body": {
"type": "string",
"maxLength": 500000,
"description": "Plain-text body."
},
"segment_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Optional segment of the FIRST list to narrow the audience."
},
"reply_to_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Sender id used for replies."
}
}
},
"annotations": {
"title": "Create campaign (draft)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "emailchef_update_campaign",
"title": "Update draft campaign",
"description": "WRITE: change a DRAFT campaign's name, subject, body, sender, reply-to or recipient lists. Only the fields you pass change: the tool reads the campaign first and sends the complete record back, because Emailchef blanks any omitted field. Refuses a campaign that is not a DRAFT. PUT /newsletters/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1
},
"list_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"maxItems": 20,
"minItems": 1,
"description": "Replace the recipient lists (any segment is dropped unless segment_id is also passed)."
},
"html_body": {
"type": "string",
"maxLength": 2000000
},
"sender_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"text_body": {
"type": "string",
"maxLength": 500000
},
"segment_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Segment of the first list (only with list_ids)."
},
"campaign_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
},
"reply_to_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,18}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Numeric id (as returned by the list tools)."
}
}
},
"annotations": {
"title": "Update draft campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}