# Sender — how to use (mcp.ai)

Connect your Sender account and use 8 tools for email newsletters straight from your AI agent. Connect with your own API key. Email marketing platform for creating campaigns, automating workflows, and tracking results.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_sender?ms=1787293440000`
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. `sender_create_field`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/sender`
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/sender/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/sender/create/field` — Tool to create a new custom subscriber field in Sender.net. Use when you need to add custom fields for email personalization, segmentation, or storing additional subscriber information like company na
  - body: { type: string, title: string }
- `POST https://api.mcp.ai/api/sender/create/or/update/subscriber` — Tool to create a new subscriber or update an existing one in Sender.net. Use when you need to add new subscribers to your email list or update existing subscriber information. This performs an upsert 
  - body: { email: string, phone?: string, fields?: object, groups?: string[], lastname?: string, firstname?: string, trigger_automation?: boolean }
- `POST https://api.mcp.ai/api/sender/get/all/fields` — Tool to retrieve a list of all custom subscriber fields configured in the Sender.net account. Use when you need to view available fields for email personalization, segmentation, or managing subscriber
- `POST https://api.mcp.ai/api/sender/get/all/workflows` — Tool to retrieve a list of all automation workflows in the Sender account. Use when you need to view or manage automation workflows.
- `POST https://api.mcp.ai/api/sender/get/campaign/by/id` — Tool to retrieve a specific campaign by its unique ID from Sender. Use when you need detailed information about a campaign including delivery metrics and engagement statistics.
  - body: { campaign_id: string }
- `POST https://api.mcp.ai/api/sender/get/group/by/id` — Tool to retrieve a specific subscriber group by its unique ID from Sender. Use when you need detailed information about a single group including subscriber counts.
  - body: { group_id: string }
- `POST https://api.mcp.ai/api/sender/get/subscriber/by/id` — Tool to retrieve a specific subscriber by their unique ID from Sender. Use when you need to fetch detailed information about a single subscriber including their status, groups, and custom fields.
  - body: { subscriber_id: string }
- `POST https://api.mcp.ai/api/sender/update/subscriber/fields` — Tool to update custom fields and information for an existing subscriber in Sender.net. Use when you need to modify subscriber details such as email, first name, last name, groups, or custom fields for
  - body: { email?: string, groups?: string[], lastname?: string, firstname?: string, subscriber_id: string }

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

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