mailbluster_list_fields
List custom lead fields
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.
Takes no parameters.
io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.4Updated Nov 7, 2026
Manage MailBluster leads, custom fields, products and orders: look up, add and update records.
The publisher's own server: Ably MCP by usefulapi
Hosted MailBluster connector that lets an assistant look up, add and update leads, custom fields, products and order records.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fmailbluster/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"mailbluster-by-usefulapi": {
"type": "http",
"url": "https://mailbluster.usefulapi.io/mcp"
}
}
}Use MailBluster from Claude, Cursor, or any MCP client — look up and add leads, custom fields, products and orders for your e-commerce email marketing. Hosted, no local install: connect with your own MailBluster credentials.
Live endpoint: https://mailbluster.usefulapi.io/mcp · Homepage: https://usefulapi.io/mailbluster
https://mailbluster.usefulapi.io/mcp.claude mcp add --transport http mailbluster https://mailbluster.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your MailBluster credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/mailbluster/
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with mailbluster_upgrade (it returns a Stripe Checkout link). Cancel any time with mailbluster_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running mailbluster_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by MailBluster.
Source: servers/mailbluster/README.md at commit 4046075
List custom lead fields
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.
Takes no parameters.
Create custom lead field
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.
field_labelrequiredfield_merge_tagrequiredGet lead
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)}.
emaillead_hashCreate lead
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.
tagsemailrequiredfieldstimezonelast_namefirst_nameip_addresssubscribedoverwrite_existingUpdate lead
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)}.
emailfieldsadd_tagstimezonelast_namelead_hashnew_emailfirst_nameip_addresssubscribedremove_tagsList products
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.
page_noper_pageGet product
Get one product record by the id you registered it under. GET /products/{product_id}.
product_idrequiredCreate product
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.
namerequiredproduct_idrequiredUpdate product
WRITE: rename a product record. PUT /products/{product_id}.
namerequiredproduct_idrequiredList orders
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.
page_noper_pageGet order
Get one order record by the id it was created with. GET /orders/{order_id}.
order_idrequiredCreate order record
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.
itemsrequiredcurrencyrequiredcustomerrequiredorder_idrequiredcampaign_idtotal_pricerequiredUpdate order record
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}.
itemscurrencyorder_idrequiredcampaign_idtotal_price100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.
io.usefulapiOfficial publisher
Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.
io.usefulapiOfficial publisher
Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.
{ "mcpServers": { "mailbluster": { "url": "https://mailbluster.usefulapi.io/mcp" } }}