MailBluster MCP by usefulapi is an MCP server published by io.usefulapi, hosted at mailbluster.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including mailbluster_list_fields, mailbluster_create_field, mailbluster_get_lead, mailbluster_create_lead, mailbluster_update_lead.
Manage MailBluster leads, custom fields, products and orders: look up, add and update records.
4,148 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the brand's custom lead fields: id, label and merge tag. Use the merge tags as keys of `fields` when creating or updating leads. GET /fields.
No parameters.
{
"name": "mailbluster_list_fields",
"title": "List custom lead fields",
"description": "List the brand's custom lead fields: id, label and merge tag. Use the merge tags as keys of `fields` when creating or updating leads. GET /fields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List custom lead fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
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.
WRITE: create a custom lead field. The merge tag is the key used in lead `fields` and in email templates. Creating a field changes the brand's data model but sends nothing. POST /fields.
| Parameter | Type | Description |
|---|---|---|
| field_label * | string | Display label, e.g. Gender. |
| field_merge_tag * | string | Merge tag, e.g. gender. |
{
"name": "mailbluster_create_field",
"title": "Create custom lead field",
"description": "WRITE: create a custom lead field. The merge tag is the key used in lead `fields` and in email templates. Creating a field changes the brand's data model but sends nothing. POST /fields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"field_label",
"field_merge_tag"
],
"properties": {
"field_label": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Display label, e.g. Gender."
},
"field_merge_tag": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Merge tag, e.g. gender."
}
}
},
"annotations": {
"title": "Create custom lead field",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Get one lead by email address (the server computes the MD5 id MailBluster uses): name, custom fields, timezone, subscribed and opt-in status, tags, created/updated dates. MailBluster has no list-leads endpoint. GET /leads/{md5(email)}.
| Parameter | Type | Description |
|---|---|---|
| string | The lead's email address (preferred). | |
| lead_hash | string | Alternative to email: the 32-character MD5 hex of the lowercased email. |
{
"name": "mailbluster_get_lead",
"title": "Get lead",
"description": "Get one lead by email address (the server computes the MD5 id MailBluster uses): name, custom fields, timezone, subscribed and opt-in status, tags, created/updated dates. MailBluster has no list-leads endpoint. GET /leads/{md5(email)}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3,
"description": "The lead's email address (preferred)."
},
"lead_hash": {
"type": "string",
"description": "Alternative to email: the 32-character MD5 hex of the lowercased email."
}
}
},
"annotations": {
"title": "Get lead",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: add a lead (contact) to the brand. `subscribed` defaults to FALSE: the lead is stored but is not subscribed to email. Only set subscribed=true when the person has given consent to receive email from this brand (the user is responsible for lawful consent); this server never subscribes anyone on its own. No email is sent by this tool (double opt-in is not offered). If the lead already exists the call fails unless overwrite_existing=true, which replaces the stored data (then `subscribed` must be given explicitly). POST /leads.
| Parameter | Type | Description |
|---|---|---|
| tags | array | Tag names to attach (created if missing). |
| email * | string | Email address. |
| fields | object | Custom field values keyed by the field's MERGE TAG (see mailbluster_list_fields), e.g. {"company": "Pied Piper"}. |
| timezone | string | IANA timezone, e.g. America/Los_Angeles. |
| last_name | string | |
| first_name | string | |
| ip_address | string | Lead's IP address; MailBluster derives country/city/timezone from it. |
| subscribed | boolean | Default false. true only with the lead's consent to receive email. |
| overwrite_existing | boolean | Default false. true overwrites an existing lead with the same email. |
{
"name": "mailbluster_create_lead",
"title": "Create lead",
"description": "WRITE: add a lead (contact) to the brand. `subscribed` defaults to FALSE: the lead is stored but is not subscribed to email. Only set subscribed=true when the person has given consent to receive email from this brand (the user is responsible for lawful consent); this server never subscribes anyone on its own. No email is sent by this tool (double opt-in is not offered). If the lead already exists the call fails unless overwrite_existing=true, which replaces the stored data (then `subscribed` must be given explicitly). POST /leads.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50,
"description": "Tag names to attach (created if missing)."
},
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3,
"description": "Email address."
},
"fields": {
"type": "object",
"description": "Custom field values keyed by the field's MERGE TAG (see mailbluster_list_fields), e.g. {\"company\": \"Pied Piper\"}.",
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"timezone": {
"type": "string",
"maxLength": 100,
"description": "IANA timezone, e.g. America/Los_Angeles."
},
"last_name": {
"type": "string",
"maxLength": 190
},
"first_name": {
"type": "string",
"maxLength": 190
},
"ip_address": {
"type": "string",
"maxLength": 64,
"description": "Lead's IP address; MailBluster derives country/city/timezone from it."
},
"subscribed": {
"type": "boolean",
"description": "Default false. true only with the lead's consent to receive email."
},
"overwrite_existing": {
"type": "boolean",
"description": "Default false. true overwrites an existing lead with the same email."
}
}
},
"annotations": {
"title": "Create lead",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: change an existing lead's name, custom fields, email, timezone, IP address, subscription flag or tags (send only what should change). `subscribed` is left alone unless you pass it; false unsubscribes the lead, true re-subscribes. Only set subscribed=true when the person has given consent to receive email from this brand (the user is responsible for lawful consent); this server never subscribes anyone on its own. PUT /leads/{md5(email)}.
| Parameter | Type | Description |
|---|---|---|
| string | Current email of the lead to update (preferred). | |
| fields | object | Custom field values keyed by the field's MERGE TAG (see mailbluster_list_fields), e.g. {"company": "Pied Piper"}. |
| add_tags | array | Tag names to attach (created if missing). Applied before remove_tags. |
| timezone | string | |
| last_name | string | |
| lead_hash | string | Alternative to email: the 32-character MD5 hex of the lowercased current email. |
| new_email | string | Change the lead's email address to this. |
| first_name | string | |
| ip_address | string | |
| subscribed | boolean | Only pass to change the subscription. true only with the lead's consent. |
| remove_tags | array | Tag names to detach. |
{
"name": "mailbluster_update_lead",
"title": "Update lead",
"description": "WRITE: change an existing lead's name, custom fields, email, timezone, IP address, subscription flag or tags (send only what should change). `subscribed` is left alone unless you pass it; false unsubscribes the lead, true re-subscribes. Only set subscribed=true when the person has given consent to receive email from this brand (the user is responsible for lawful consent); this server never subscribes anyone on its own. PUT /leads/{md5(email)}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3,
"description": "Current email of the lead to update (preferred)."
},
"fields": {
"type": "object",
"description": "Custom field values keyed by the field's MERGE TAG (see mailbluster_list_fields), e.g. {\"company\": \"Pied Piper\"}.",
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"add_tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50,
"description": "Tag names to attach (created if missing). Applied before remove_tags."
},
"timezone": {
"type": "string",
"maxLength": 100
},
"last_name": {
"type": "string",
"maxLength": 190
},
"lead_hash": {
"type": "string",
"description": "Alternative to email: the 32-character MD5 hex of the lowercased current email."
},
"new_email": {
"type": "string",
"maxLength": 320,
"minLength": 3,
"description": "Change the lead's email address to this."
},
"first_name": {
"type": "string",
"maxLength": 190
},
"ip_address": {
"type": "string",
"maxLength": 64
},
"subscribed": {
"type": "boolean",
"description": "Only pass to change the subscription. true only with the lead's consent."
},
"remove_tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50,
"description": "Tag names to detach."
}
}
},
"annotations": {
"title": "Update lead",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}List product records (id, name, dates) the brand has registered for e-commerce tracking. Paged: the reply's meta has total and nextPageNo (null on the last page). GET /products.
| Parameter | Type | Description |
|---|---|---|
| page_no | integer | Page number, from 1 (default 1). Pass the previous reply's meta.nextPageNo. |
| per_page | integer | Results per page, 1-100 (MailBluster default 10). |
{
"name": "mailbluster_list_products",
"title": "List products",
"description": "List product records (id, name, dates) the brand has registered for e-commerce tracking. Paged: the reply's meta has total and nextPageNo (null on the last page). GET /products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_no": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's meta.nextPageNo.",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (MailBluster default 10).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one product record by the id you registered it under. GET /products/{product_id}.
| Parameter | Type | Description |
|---|---|---|
| product_id * | string | Product id. |
{
"name": "mailbluster_get_product",
"title": "Get product",
"description": "Get one product record by the id you registered it under. GET /products/{product_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Product id."
}
}
},
"annotations": {
"title": "Get product",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: register a product record (your own id plus a name) so orders can reference it. Sends nothing to anyone and charges nothing. POST /products.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Product name. |
| product_id * | string | Your unique product id. |
{
"name": "mailbluster_create_product",
"title": "Create product",
"description": "WRITE: register a product record (your own id plus a name) so orders can reference it. Sends nothing to anyone and charges nothing. POST /products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Product name."
},
"product_id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Your unique product id."
}
}
},
"annotations": {
"title": "Create product",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: rename a product record. PUT /products/{product_id}.
| Parameter | Type | Description |
|---|---|---|
| name * | string | New product name. |
| product_id * | string | Product id. |
{
"name": "mailbluster_update_product",
"title": "Update product",
"description": "WRITE: rename a product record. PUT /products/{product_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "New product name."
},
"product_id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Product id."
}
}
},
"annotations": {
"title": "Update product",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}List order records (id, currency, total price, customer lead, campaign, line items). These are records kept in MailBluster for tracking; no payment is involved. Paged: see meta.nextPageNo. GET /orders.
| Parameter | Type | Description |
|---|---|---|
| page_no | integer | Page number, from 1 (default 1). Pass the previous reply's meta.nextPageNo. |
| per_page | integer | Results per page, 1-100 (MailBluster default 10). |
{
"name": "mailbluster_list_orders",
"title": "List orders",
"description": "List order records (id, currency, total price, customer lead, campaign, line items). These are records kept in MailBluster for tracking; no payment is involved. Paged: see meta.nextPageNo. GET /orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_no": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's meta.nextPageNo.",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (MailBluster default 10).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get one order record by the id it was created with. GET /orders/{order_id}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | Order id. |
{
"name": "mailbluster_get_order",
"title": "Get order",
"description": "Get one order record by the id it was created with. GET /orders/{order_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Order id."
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: record an order (a tracking record: it does not take payment, charge a card or send email). The customer's email becomes a lead if none exists, and the lead's tags are merged. `customer.subscribed` is REQUIRED because MailBluster would otherwise default it to true: pass false unless the customer has consented to email. For a customer who already exists, the value may replace their stored subscription state. Only set subscribed=true when the person has given consent to receive email from this brand (the user is responsible for lawful consent); this server never subscribes anyone on its own. POST /orders.
| Parameter | Type | Description |
|---|---|---|
| items * | array | Ordered products. |
| currency * | string | ISO currency code, e.g. USD. |
| customer * | object | |
| order_id * | string | Your unique order id. |
| campaign_id | integer | Id of the campaign that led to the order, if any. |
| total_price * | number | Order total, e.g. 10.64. |
{
"name": "mailbluster_create_order",
"title": "Create order record",
"description": "WRITE: record an order (a tracking record: it does not take payment, charge a card or send email). The customer's email becomes a lead if none exists, and the lead's tags are merged. `customer.subscribed` is REQUIRED because MailBluster would otherwise default it to true: pass false unless the customer has consented to email. For a customer who already exists, the value may replace their stored subscription state. Only set subscribed=true when the person has given consent to receive email from this brand (the user is responsible for lawful consent); this server never subscribes anyone on its own. POST /orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"customer",
"currency",
"total_price",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"price",
"quantity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Your id of the product (a product record with this id is created in MailBluster if it does not exist)."
},
"name": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Product name."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Unit price, e.g. 3.15."
},
"quantity": {
"type": "integer",
"maximum": 1000000,
"exclusiveMinimum": 0
}
}
},
"maxItems": 200,
"minItems": 1,
"description": "Ordered products."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO currency code, e.g. USD."
},
"customer": {
"type": "object",
"required": [
"email",
"subscribed"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50
},
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3,
"description": "Email address."
},
"fields": {
"type": "object",
"description": "Custom field values keyed by the field's MERGE TAG (see mailbluster_list_fields), e.g. {\"company\": \"Pied Piper\"}.",
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"timezone": {
"type": "string",
"maxLength": 100
},
"last_name": {
"type": "string",
"maxLength": 190
},
"first_name": {
"type": "string",
"maxLength": 190
},
"ip_address": {
"type": "string",
"maxLength": 64
},
"subscribed": {
"type": "boolean",
"description": "Required. true only with the customer's consent to receive email; otherwise false."
}
}
},
"order_id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Your unique order id."
},
"campaign_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Id of the campaign that led to the order, if any.",
"exclusiveMinimum": 0
},
"total_price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Order total, e.g. 10.64."
}
}
},
"annotations": {
"title": "Create order record",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: change an order record's campaign, currency, total or items (send only what should change; `items`, when given, REPLACES all previous items). The customer cannot be changed here. No payment or email is involved. PUT /orders/{order_id}.
| Parameter | Type | Description |
|---|---|---|
| items | array | New complete item list; replaces the previous items. |
| currency | string | ISO currency code, e.g. USD. |
| order_id * | string | Order id. |
| campaign_id | integer | |
| total_price | number | New order total. |
{
"name": "mailbluster_update_order",
"title": "Update order record",
"description": "WRITE: change an order record's campaign, currency, total or items (send only what should change; `items`, when given, REPLACES all previous items). The customer cannot be changed here. No payment or email is involved. PUT /orders/{order_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"price",
"quantity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Your id of the product (a product record with this id is created in MailBluster if it does not exist)."
},
"name": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Product name."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Unit price, e.g. 3.15."
},
"quantity": {
"type": "integer",
"maximum": 1000000,
"exclusiveMinimum": 0
}
}
},
"maxItems": 200,
"minItems": 1,
"description": "New complete item list; replaces the previous items."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO currency code, e.g. USD."
},
"order_id": {
"type": "string",
"maxLength": 190,
"minLength": 1,
"description": "Order id."
},
"campaign_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"total_price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "New order total."
}
}
},
"annotations": {
"title": "Update order record",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for MailBluster, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Look up the lead customer@example.com and show their contact details."; "List the orders recorded for my shop with their totals."; "Which products have I registered for my shop's sales tracking?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes MailBluster data. Free plan: 50 tool calls per month. Run mailbluster_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 mailbluster_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 mailbluster_upgrade without a plan: it returns both plans, each with a payment link for the user to open. mailbluster_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.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.