# MailBluster — how to use (mcp.ai)

Connect your MailBluster account and use 15 tools for email newsletters straight from your AI agent. Connect with your own API key. MailBluster is an advanced, reliable, and cost-effective email marketing software that enables sending personalized promotional emails to millions.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mailbluster?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mailbluster_create_lead`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mailbluster`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mailbluster/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mailbluster/create/lead` — Tool to create a new lead in MailBluster. Use after gathering the lead's email and optional data.
  - body: { tags?: string[], email: string, fields?: object|object[], lastName?: string, firstName?: string, subscribed?: boolean }
- `POST https://api.mcp.ai/api/mailbluster/create/order` — Tool to create a new order in MailBluster.
  - body: { id: string, items: object[], currency: string, customer: object, ipAddress?: string, totalPrice: number }
- `POST https://api.mcp.ai/api/mailbluster/create/product` — Tool to create a new product in MailBluster. Use when you have all product details ready to add it to your MailBluster catalog. Requires a unique product ID and name.
  - body: { id: string, url?: string, name: string, price?: number, imageUrl?: string, published?: boolean }
- `POST https://api.mcp.ai/api/mailbluster/delete/lead` — Tool to delete a lead by lead email hash. Use after confirming the lead hash (MD5 encrypted email address).
  - body: { lead_hash: string }
- `POST https://api.mcp.ai/api/mailbluster/delete/order` — Tool to delete a specific order. Use after confirming the order ID to remove an order from Mailbluster.
  - body: { order_id: string }
- `POST https://api.mcp.ai/api/mailbluster/delete/product` — Tool to delete a product. Use after confirming product existence.
  - body: { product_id: string }
- `POST https://api.mcp.ai/api/mailbluster/get/lead` — Tool to retrieve a specific lead's information using their lead hash (MD5 encrypted email address). Use when you need to fetch lead details by their email hash.
  - body: { lead_hash: string }
- `POST https://api.mcp.ai/api/mailbluster/get/order` — Tool to retrieve details of a specific order. Use when you have the order's ID.
  - body: { order_id: string }
- `POST https://api.mcp.ai/api/mailbluster/get/product` — Tool to retrieve details of a specific product. Use when you have a valid product ID and need full product information.
  - body: { product_id: string }
- `POST https://api.mcp.ai/api/mailbluster/list/fields` — Tool to list all custom fields. Use when you need to retrieve all defined custom fields after authenticating with MailBluster.
- `POST https://api.mcp.ai/api/mailbluster/list/orders` — Tool to list all orders. Use when you need to retrieve orders with optional pagination, sorting, or searching after authenticating with Mailbluster.
  - body: { page?: integer, sort?: string, limit?: integer, order?: string, search?: string }
- `POST https://api.mcp.ai/api/mailbluster/list/products` — Tool to list all products. Use when you need to retrieve products with optional pagination, sorting, or filtering.
  - body: { pageNo?: integer, perPage?: integer }
- `POST https://api.mcp.ai/api/mailbluster/update/lead` — Tool to update an existing lead's information in MailBluster. Use when you need to modify lead details, subscription status, or manage tags.
  - body: { email?: string, fields?: object, addTags?: string[], lastName?: string, timezone?: string, firstName?: string, ipAddress?: string, lead_hash: string, removeTags?: string[], subscribed?: boolean }
- `POST https://api.mcp.ai/api/mailbluster/update/order` — Tool to update an existing order's customer details, currency, price, and items in MailBluster. Use when you need to modify an order.
  - body: { items?: object[], currency?: string, customer?: object, order_id: string, campaignId?: integer, totalPrice?: number }
- `POST https://api.mcp.ai/api/mailbluster/update/product` — Tool to update a product in MailBluster by its ID. Use after confirming the product ID to modify attributes.
  - body: { url?: string, name: string, price?: number, currency?: string, imageUrl?: string, productId: string, description?: string }

## Example prompts
- "What can I do in MailBluster?"
- "Show me a summary of my MailBluster account"

## More
- Page: https://mcp.ai/mailbluster
- Agent spec (llms.txt): https://mcp.ai/mailbluster/llms.txt
- Postman collection: https://mcp.ai/mailbluster/postman.json