# Sendfox — how to use (mcp.ai)

Connect your Sendfox account and use 17 tools for email newsletters straight from your AI agent. Connect with your own API key. Sendfox is an affordable email marketing platform for content creators. Manage contacts, create email campaigns, automate sequences, and grow your audience.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/sendfox/delete/contact/from/list` — Tool to remove a contact from a specific list in SendFox. Use when you need to disassociate a contact from a list without deleting the contact entirely. The contact will remain in your account but wil
  - body: { list_id: integer, contact_id: integer }
- `POST https://api.mcp.ai/api/sendfox/get/automations` — Tool to retrieve a list of automations. Use when you need to list all automations for your SendFox account.
- `POST https://api.mcp.ai/api/sendfox/get/campaign/by/id` — Retrieve details for a specific campaign by its ID from SendFox. Use this when you need to fetch information about a particular campaign. Returns campaign details including title, subject, HTML conten
  - body: { id: integer }
- `POST https://api.mcp.ai/api/sendfox/get/campaigns` — Retrieve a paginated list of email campaigns from SendFox. Use this to fetch all campaigns or navigate through pages of results. Returns campaign details including status, subject, content, and timest
  - body: { page?: integer }
- `POST https://api.mcp.ai/api/sendfox/get/contact/by/id` — Retrieves a contact's details by their unique ID from SendFox. Use this tool when you need to look up a specific contact's information after obtaining their ID from a contact list or other API respons
  - body: { contact_id: integer }
- `POST https://api.mcp.ai/api/sendfox/get/contact/fields` — Retrieves all contact fields available in the SendFox account. Use this to discover available fields before creating or updating contacts. Returns standard fields (email, first_name, last_name) and an
- `POST https://api.mcp.ai/api/sendfox/get/contacts` — Tool to retrieve a paginated list of contacts. Use when you need to fetch contacts in pages, optionally filtering by email.
  - body: { page?: integer, email?: string }
- `POST https://api.mcp.ai/api/sendfox/get/contacts/in/list` — Tool to retrieve contacts in a specific list. Use when you need to fetch all contacts belonging to a particular list, optionally filtering by search query.
  - body: { query?: string, list_id: integer }
- `POST https://api.mcp.ai/api/sendfox/get/current/user` — Tool to retrieve information about the authenticated user from SendFox. Returns user details including name, email, contact count, and contact limit. Use this tool when you need to check account infor
- `POST https://api.mcp.ai/api/sendfox/get/forms` — Tool to retrieve a paginated list of forms from SendFox. Use when you need to fetch all forms or search for specific forms by query.
  - body: { query?: string }
- `POST https://api.mcp.ai/api/sendfox/get/list/by/id` — Retrieves details of a specific contact list by its ID from SendFox. Use this tool when you need information about a particular list (name, contact count, timestamps). Requires a valid list_id which c
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/sendfox/get/lists` — Retrieve all contact lists from your SendFox account with pagination support. Use this tool when you need to: - Fetch all available contact lists for your account - Get list IDs to use with other Send
  - body: { page?: integer }
- `POST https://api.mcp.ai/api/sendfox/list/contact/fields` — Tool to list all custom contact fields defined by the user. Returns a paginated list of contact fields with their IDs, names, and timestamps.
- `POST https://api.mcp.ai/api/sendfox/list/unsubscribed/contacts` — Tool to retrieve a paginated list of contacts who have unsubscribed. Use when you need to fetch unsubscribed contacts, optionally filtering by search query.
  - body: { page?: integer, query?: string }
- `POST https://api.mcp.ai/api/sendfox/patch/unsubscribe/contact` — Unsubscribe a contact from all email communications in your SendFox account. Use this tool when you need to: - Globally unsubscribe a contact from all future emails - Honor unsubscribe requests from s
  - body: { email: string }
- `POST https://api.mcp.ai/api/sendfox/post/create/contact` — Create a new contact (subscriber) in your SendFox account. Use this tool when you need to: - Add a new subscriber to your email list - Create a contact with optional first/last name - Add a contact to
  - body: { email: string, lists?: integer[], last_name?: string, first_name?: string }
- `POST https://api.mcp.ai/api/sendfox/post/create/list` — Create a new contact list in your SendFox account. Use this tool when you need to: - Create a new mailing list for organizing contacts - Set up a list before adding subscribers to it - Segment your au
  - body: { name: string }

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

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