Mail Blaze MCP by usefulapi is an MCP server published by io.usefulapi, hosted at mailblaze.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 26 tools, including mailblaze_list_lists, mailblaze_get_list, mailblaze_list_list_fields, mailblaze_list_segments, mailblaze_list_subscribers.
Manage Mail Blaze lists, subscribers, templates, campaigns and reports; send transactional email.
4,326 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.
List the account's mailing lists (name, uid, subscriber counts, defaults). Use the list uid in the other tools. Paged: page + per_page.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
| per_page | integer | Lists per page (default set by Mail Blaze). |
{
"name": "mailblaze_list_lists",
"title": "List mailing lists",
"description": "List the account's mailing lists (name, uid, subscriber counts, defaults). Use the list uid in the other tools. Paged: page + per_page.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Lists per page (default set by Mail Blaze)."
}
}
},
"annotations": {
"title": "List mailing lists",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one mailing list by its uid: general settings, default sender, company details and counts.
| Parameter | Type | Description |
|---|---|---|
| list_uid * | string | List uid from mailblaze_list_lists. |
{
"name": "mailblaze_get_list",
"title": "Get a mailing list",
"description": "Get one mailing list by its uid: general settings, default sender, company details and counts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid"
],
"properties": {
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1,
"description": "List uid from mailblaze_list_lists."
}
}
},
"annotations": {
"title": "Get a mailing list",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the fields of a mailing list (label, tag, type, required). The tags (EMAIL, FNAME, LNAME, custom ones) are the keys used when adding or updating subscribers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
| list_uid * | string |
{
"name": "mailblaze_list_list_fields",
"title": "List a list's custom fields",
"description": "List the fields of a mailing list (label, tag, type, required). The tags (EMAIL, FNAME, LNAME, custom ones) are the keys used when adding or updating subscribers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "List a list's custom fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the segments defined on a mailing list (uid, name). A segment uid can be used when creating a campaign.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
| list_uid * | string |
{
"name": "mailblaze_list_segments",
"title": "List a list's segments",
"description": "List the segments defined on a mailing list (uid, name). A segment uid can be used when creating a campaign.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "List a list's segments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the subscribers of a mailing list (sets of 10 per page; use page to go on). Contains personal data (emails, names).
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
| list_uid * | string |
{
"name": "mailblaze_list_subscribers",
"title": "List subscribers",
"description": "List the subscribers of a mailing list (sets of 10 per page; use page to go on). Contains personal data (emails, names).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "List subscribers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one subscriber of a list by subscriber uid (status, fields, dates).
| Parameter | Type | Description |
|---|---|---|
| list_uid * | string | |
| subscriber_uid * | string | Subscriber uid from mailblaze_list_subscribers or mailblaze_find_subscriber_by_email. |
{
"name": "mailblaze_get_subscriber",
"title": "Get a subscriber",
"description": "Get one subscriber of a list by subscriber uid (status, fields, dates).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"subscriber_uid"
],
"properties": {
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"subscriber_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1,
"description": "Subscriber uid from mailblaze_list_subscribers or mailblaze_find_subscriber_by_email."
}
}
},
"annotations": {
"title": "Get a subscriber",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Look up a subscriber in one list by email address. Returns the subscriber (with its uid) or a not-found error.
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| list_uid * | string |
{
"name": "mailblaze_find_subscriber_by_email",
"title": "Find a subscriber by email",
"description": "Look up a subscriber in one list by email address. Returns the subscriber (with its uid) or a not-found error.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Find a subscriber by email",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE, MAY SEND A CONFIRMATION EMAIL: add one subscriber to a mailing list. Depending on the list's settings Mail Blaze may send the person a confirmation (double opt-in) email. Only add people who agreed to receive your email. An email that is already on the list answers with a conflict error.
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| list_uid * | string | |
| last_name | string | Sets the LNAME field. |
| first_name | string | Sets the FNAME field. |
| custom_fields | object | Custom field values keyed by the field's tag (see mailblaze_list_list_fields), e.g. {"PHONE": "+1 555 0100"}. |
{
"name": "mailblaze_add_subscriber",
"title": "Add a subscriber",
"description": "WRITE, MAY SEND A CONFIRMATION EMAIL: add one subscriber to a mailing list. Depending on the list's settings Mail Blaze may send the person a confirmation (double opt-in) email. Only add people who agreed to receive your email. An email that is already on the list answers with a conflict error.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"last_name": {
"type": "string",
"maxLength": 255,
"description": "Sets the LNAME field."
},
"first_name": {
"type": "string",
"maxLength": 255,
"description": "Sets the FNAME field."
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's tag (see mailblaze_list_list_fields), e.g. {\"PHONE\": \"+1 555 0100\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
}
}
},
"annotations": {
"title": "Add a subscriber",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE, MAY SEND CONFIRMATION EMAILS: add up to 100 subscribers to a mailing list in one request; an email already on the list is updated instead. Depending on the list's settings Mail Blaze may send confirmation emails. Only add people who agreed to receive your email.
| Parameter | Type | Description |
|---|---|---|
| list_uid * | string | |
| subscribers * | array | 1 to 100 subscribers. |
{
"name": "mailblaze_add_subscribers_bulk",
"title": "Add or update subscribers in bulk",
"description": "WRITE, MAY SEND CONFIRMATION EMAILS: add up to 100 subscribers to a mailing list in one request; an email already on the list is updated instead. Depending on the list's settings Mail Blaze may send confirmation emails. Only add people who agreed to receive your email.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"subscribers"
],
"properties": {
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"subscribers": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
},
"last_name": {
"type": "string",
"maxLength": 255
},
"first_name": {
"type": "string",
"maxLength": 255
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's tag (see mailblaze_list_list_fields), e.g. {\"PHONE\": \"+1 555 0100\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "1 to 100 subscribers."
}
}
},
"annotations": {
"title": "Add or update subscribers in bulk",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: update a subscriber's name or custom fields. Pass the subscriber's current email (Mail Blaze requires it) plus only the values to change. Does not change subscription status.
| Parameter | Type | Description |
|---|---|---|
| email * | string | The subscriber's email (Mail Blaze requires it on update). |
| list_uid * | string | |
| last_name | string | |
| first_name | string | |
| custom_fields | object | Custom field values keyed by the field's tag (see mailblaze_list_list_fields), e.g. {"PHONE": "+1 555 0100"}. |
| subscriber_uid * | string |
{
"name": "mailblaze_update_subscriber",
"title": "Update a subscriber",
"description": "WRITE: update a subscriber's name or custom fields. Pass the subscriber's current email (Mail Blaze requires it) plus only the values to change. Does not change subscription status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"subscriber_uid",
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3,
"description": "The subscriber's email (Mail Blaze requires it on update)."
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"last_name": {
"type": "string",
"maxLength": 255
},
"first_name": {
"type": "string",
"maxLength": 255
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's tag (see mailblaze_list_list_fields), e.g. {\"PHONE\": \"+1 555 0100\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
},
"subscriber_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Update a subscriber",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: set a subscriber's status to unsubscribed so they receive no more campaigns from this list. By default Mail Blaze also adds the address to the account's local blacklist. Do this only when the person asked to stop (or a data-protection request requires it). The subscriber record is kept.
| Parameter | Type | Description |
|---|---|---|
| list_uid * | string | |
| subscriber_uid * | string |
{
"name": "mailblaze_unsubscribe_subscriber",
"title": "Unsubscribe a subscriber",
"description": "WRITE: set a subscriber's status to unsubscribed so they receive no more campaigns from this list. By default Mail Blaze also adds the address to the account's local blacklist. Do this only when the person asked to stop (or a data-protection request requires it). The subscriber record is kept.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"subscriber_uid"
],
"properties": {
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"subscriber_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Unsubscribe a subscriber",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: set a previously unsubscribed subscriber back to subscribed so campaigns reach them again. Only do this when the person asked to be re-added (consent).
| Parameter | Type | Description |
|---|---|---|
| list_uid * | string | |
| subscriber_uid * | string |
{
"name": "mailblaze_resubscribe_subscriber",
"title": "Resubscribe a subscriber",
"description": "WRITE: set a previously unsubscribed subscriber back to subscribed so campaigns reach them again. Only do this when the person asked to be re-added (consent).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_uid",
"subscriber_uid"
],
"properties": {
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"subscriber_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Resubscribe a subscriber",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List the account's email templates (uid, name). A template uid is needed to create a campaign.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
{
"name": "mailblaze_list_templates",
"title": "List email templates",
"description": "List the account's email templates (uid, name). A template uid is needed to create a campaign.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
}
}
},
"annotations": {
"title": "List email templates",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one email template by uid (name and content).
| Parameter | Type | Description |
|---|---|---|
| template_uid * | string |
{
"name": "mailblaze_get_template",
"title": "Get an email template",
"description": "Get one email template by uid (name and content).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"template_uid"
],
"properties": {
"template_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Get an email template",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create an email template from HTML (the tool base64-encodes it). Mail Blaze requires the HTML to contain an unsubscribe link. Sends nothing.
| Parameter | Type | Description |
|---|---|---|
| html * | string | The full HTML of the email, including an unsubscribe link. |
| name * | string |
{
"name": "mailblaze_create_template",
"title": "Create an email template",
"description": "WRITE: create an email template from HTML (the tool base64-encodes it). Mail Blaze requires the HTML to contain an unsubscribe link. Sends nothing.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"html"
],
"properties": {
"html": {
"type": "string",
"maxLength": 1000000,
"minLength": 1,
"description": "The full HTML of the email, including an unsubscribe link."
},
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
}
}
},
"annotations": {
"title": "Create an email template",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}List the account's email campaigns (uid, name, status, dates). Use the campaign uid for details and reports.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
{
"name": "mailblaze_list_campaigns",
"title": "List campaigns",
"description": "List the account's email campaigns (uid, name, status, dates). Use the campaign uid for details and reports.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
}
}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one campaign by uid: sender, subject, list, template, status and schedule.
| Parameter | Type | Description |
|---|---|---|
| campaign_uid * | string |
{
"name": "mailblaze_get_campaign",
"title": "Get a campaign",
"description": "Get one campaign by uid: sender, subject, list, template, status and schedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_uid"
],
"properties": {
"campaign_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Get a campaign",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE, SENDS EMAIL TO PEOPLE: create a campaign for a mailing list (or one of its segments) from an existing template and schedule it for send_at. Once it goes out it reaches every subscriber of the list or segment, may use sending credit and cannot be recalled. Confirm the list, segment, subject, template and send time with the user before calling. Needs a template uid (mailblaze_list_templates) and a list uid (mailblaze_list_lists).
| Parameter | Type | Description |
|---|---|---|
| name * | string | Internal campaign name. |
| send_at * | string | When to send, 'YYYY-MM-DD HH:MM:SS' (interpreted by Mail Blaze in the account's time zone). |
| subject * | string | |
| list_uid * | string | |
| reply_to * | string | |
| from_name * | string | |
| from_email * | string | Sender address; it must be a verified sender in Mail Blaze. |
| segment_uid | string | Send only to this segment of the list. |
Bulk report summary (sent, opens, clicks, bounces, unsubscribes) for up to 50 campaigns in one call. Read-only (it is a POST in the API only because of the id list).
| Parameter | Type | Description |
|---|---|---|
| campaign_uids * | array | 1 to 50 campaign uids. |
{
"name": "mailblaze_get_campaign_summaries",
"title": "Get campaign report summaries",
"description": "Bulk report summary (sent, opens, clicks, bounces, unsubscribes) for up to 50 campaigns in one call. Read-only (it is a POST in the API only because of the id list).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_uids"
],
"properties": {
"campaign_uids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 50,
"minItems": 1,
"description": "1 to 50 campaign uids."
}
}
},
"annotations": {
"title": "Get campaign report summaries",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Inbox-provider breakdown (e.g. Gmail, Outlook, Yahoo) of a campaign's delivery.
| Parameter | Type | Description |
|---|---|---|
| campaign_uid * | string |
{
"name": "mailblaze_get_campaign_inbox_breakdown",
"title": "Get a campaign's inbox breakdown",
"description": "Inbox-provider breakdown (e.g. Gmail, Outlook, Yahoo) of a campaign's delivery.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_uid"
],
"properties": {
"campaign_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Get a campaign's inbox breakdown",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the individual events of a campaign by kind: opens, clicks, bounces or unsubscribes. Cursor-paged: pass the reply's next_cursor back until it is null. For very large campaigns Mail Blaze answers 202 with a job_id; check it with mailblaze_get_report_job.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["opens","clicks","bounces","unsubscribes"] |
| limit | integer | Events per page (default 100, max 1000). |
| cursor | string | The next_cursor from the previous reply, passed back exactly as returned. Omit for the first page. |
| campaign_uid * | string |
{
"name": "mailblaze_list_campaign_events",
"title": "List a campaign's opens, clicks, bounces or unsubscribes",
"description": "List the individual events of a campaign by kind: opens, clicks, bounces or unsubscribes. Cursor-paged: pass the reply's next_cursor back until it is null. For very large campaigns Mail Blaze answers 202 with a job_id; check it with mailblaze_get_report_job.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_uid",
"kind"
],
"properties": {
"kind": {
"enum": [
"opens",
"clicks",
"bounces",
"unsubscribes"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Events per page (default 100, max 1000)."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The next_cursor from the previous reply, passed back exactly as returned. Omit for the first page."
},
"campaign_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "List a campaign's events",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Email activity (sends, opens, clicks, bounces) of one subscriber by email address, optionally limited to one list. Cursor-paged.
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| limit | integer | Events per page (default 100, max 1000). |
| cursor | string | The next_cursor from the previous reply, passed back exactly as returned. Omit for the first page. |
| list_uid | string |
{
"name": "mailblaze_get_subscriber_activity",
"title": "Get a subscriber's activity",
"description": "Email activity (sends, opens, clicks, bounces) of one subscriber by email address, optionally limited to one list. Cursor-paged.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Events per page (default 100, max 1000)."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The next_cursor from the previous reply, passed back exactly as returned. Omit for the first page."
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Get a subscriber's activity",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Status (and result when finished) of an asynchronous report job, as returned in a 202 reply with a job_id.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string |
{
"name": "mailblaze_get_report_job",
"title": "Get a report job's status",
"description": "Status (and result when finished) of an asynchronous report job, as returned in a 202 reply with a job_id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 128,
"minLength": 1
}
}
},
"annotations": {
"title": "Get a report job's status",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the transactional emails sent through the account (uid, recipient, subject, status). Paged.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty). |
{
"name": "mailblaze_list_transactional_emails",
"title": "List transactional emails",
"description": "List the transactional emails sent through the account (uid, recipient, subject, status). Paged.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (results come in sets of 10; keep going until a page comes back empty)."
}
}
},
"annotations": {
"title": "List transactional emails",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one transactional email by uid: recipient, subject, status and timestamps.
| Parameter | Type | Description |
|---|---|---|
| email_uid * | string |
{
"name": "mailblaze_get_transactional_email",
"title": "Get a transactional email",
"description": "Get one transactional email by uid: recipient, subject, status and timestamps.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_uid"
],
"properties": {
"email_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Get a transactional email",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE, SENDS ONE EMAIL NOW: send a single one-to-one email to one recipient through Mail Blaze. It leaves immediately, uses sending credit and cannot be recalled. Give either html (the body) or template_id (a transactional template, with merge_tags covering every tag in it), not both. Confirm the recipient and content with the user before calling. Not for bulk or marketing mail; use a campaign for that.
| Parameter | Type | Description |
|---|---|---|
| html | string | HTML body (the tool base64-encodes it). Omit when using template_id. |
| subject * | string | |
| to_name * | string | Recipient name (required by Mail Blaze). |
| to_email * | string | |
| from_name * | string | Sender name (required by Mail Blaze). |
| from_email * | string | Sender address; it must be a verified sender in Mail Blaze. |
| merge_tags | object | Template merge tags (required with template_id); every tag in the template must be present. |
| template_id | string | Transactional template id. Omit when sending html. |
Tools for MailBlaze, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many subscribers are on each of my mailing lists?"; "Show the open and click rates of my last five campaigns."; "Add jane@example.com to my newsletter list as Jane Smith.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes MailBlaze data. Free plan: 50 tool calls per month. Run mailblaze_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 mailblaze_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 mailblaze_upgrade without a plan: it returns both plans, each with a payment link for the user to open. mailblaze_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.
| template_uid * | string |
{
"name": "mailblaze_create_campaign",
"title": "Create and schedule a campaign",
"description": "WRITE, SENDS EMAIL TO PEOPLE: create a campaign for a mailing list (or one of its segments) from an existing template and schedule it for send_at. Once it goes out it reaches every subscriber of the list or segment, may use sending credit and cannot be recalled. Confirm the list, segment, subject, template and send time with the user before calling. Needs a template uid (mailblaze_list_templates) and a list uid (mailblaze_list_lists).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"from_name",
"from_email",
"reply_to",
"subject",
"list_uid",
"template_uid",
"send_at"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Internal campaign name."
},
"send_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "When to send, 'YYYY-MM-DD HH:MM:SS' (interpreted by Mail Blaze in the account's time zone)."
},
"subject": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"list_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"reply_to": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
},
"from_name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"from_email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3,
"description": "Sender address; it must be a verified sender in Mail Blaze."
},
"segment_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1,
"description": "Send only to this segment of the list."
},
"template_uid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
}
},
"annotations": {
"title": "Create and schedule a campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| reply_to_name | string |
| reply_to_email | string |
{
"name": "mailblaze_send_transactional_email",
"title": "Send a transactional email",
"description": "WRITE, SENDS ONE EMAIL NOW: send a single one-to-one email to one recipient through Mail Blaze. It leaves immediately, uses sending credit and cannot be recalled. Give either html (the body) or template_id (a transactional template, with merge_tags covering every tag in it), not both. Confirm the recipient and content with the user before calling. Not for bulk or marketing mail; use a campaign for that.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to_email",
"to_name",
"from_email",
"from_name",
"subject"
],
"properties": {
"html": {
"type": "string",
"maxLength": 1000000,
"minLength": 1,
"description": "HTML body (the tool base64-encodes it). Omit when using template_id."
},
"subject": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"to_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Recipient name (required by Mail Blaze)."
},
"to_email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
},
"from_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Sender name (required by Mail Blaze)."
},
"from_email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3,
"description": "Sender address; it must be a verified sender in Mail Blaze."
},
"merge_tags": {
"type": "object",
"description": "Template merge tags (required with template_id); every tag in the template must be present.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 10000
}
},
"template_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Transactional template id. Omit when sending html."
},
"reply_to_name": {
"type": "string",
"maxLength": 255
},
"reply_to_email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3
}
}
},
"annotations": {
"title": "Send a transactional email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}