# Reply — how to use (mcp.ai)

Connect your Reply account and use 21 tools for marketing automation straight from your AI agent. Connect with your own API key. Reply.io is a sales engagement platform that automates multichannel outreach, enabling users to create and manage email campaigns, track replies, and monitor performance directly within their platform.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/reply/create/list` — Tool to add a new personal list on the People page. Use when you need to organize contacts into a custom list.
  - body: { name: string }
- `POST https://api.mcp.ai/api/reply/delete/email/account` — Tool to delete a specific email account. Use when you need to remove an existing email account identified by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/reply/delete/list/by/id` — Tool to delete a list by its ID. Use when you need to remove a personal list you own.
  - body: { listId: integer }
- `POST https://api.mcp.ai/api/reply/delete/sequence` — Tool to delete a sequence. Use after confirming the sequence exists to remove it permanently.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/reply/delete/user` — Tool to delete a user. Use after confirming the user exists to remove them permanently.
  - body: { id: string }
- `POST https://api.mcp.ai/api/reply/generate/ulid` — Generate ULID
  - body: { seed?: string }
- `POST https://api.mcp.ai/api/reply/get/all/lists` — Tool to retrieve all available people lists. Use when you need to list all lists in your Reply account.
- `POST https://api.mcp.ai/api/reply/get/blacklist/all` — Tool to retrieve the full list of blacklisted domains and emails. Use after confirming updates to the blacklist when you need a complete view.
- `POST https://api.mcp.ai/api/reply/get/campaign/schedules/all` — Retrieves all campaign schedules from Reply.io, including the default schedule and any user-created schedules. Each schedule contains timezone settings, daily timing configurations (mainTimings), and 
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/reply/get/campaigns/for/contact` — Tool to retrieve campaigns a contact belongs to by contact ID. Use when you need to list all sequences (campaigns) associated with a specific contact.
  - body: { page?: integer, limit?: integer, contactId: integer }
- `POST https://api.mcp.ai/api/reply/get/contacts/in/list/by/id` — Tool to retrieve contacts in a specific personal list. Use after obtaining the list ID when you need a paginated set of contacts for that list.
  - body: { page?: integer, limit?: integer, list_id: string }
- `POST https://api.mcp.ai/api/reply/get/list/by/id` — Tool to return a specific people list by its ID. Use after you know the list ID and need its details.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/reply/get/templates/list` — Retrieves all email templates from Reply.io, including user-created, team-shared, organization-wide, and community templates. Use this to browse available templates before sending emails or creating c
- `POST https://api.mcp.ai/api/reply/list/campaigns` — Tool to list all campaigns (sequences). Use when you need a paginated list of campaigns.
  - body: { name?: string, page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/reply/list/contacts/basic` — Tool to list contacts. Use when verifying API access and gathering contact IDs.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/reply/list/email/accounts` — Tool to list all email accounts. Use when you need to retrieve email accounts page by page.
  - body: { page?: integer, limit?: integer, status?: string }
- `POST https://api.mcp.ai/api/reply/mark/contact/as/finished` — Marks a contact (by email) or all contacts under a domain as finished in all Reply.io campaigns. Use this tool to stop outreach for contacts who have been successfully engaged or should no longer rece
  - body: { email?: string, domain?: string }
- `POST https://api.mcp.ai/api/reply/mark/contact/as/replied` — Tool to mark a contact as replied in all campaigns by email or domain. Use after confirming the contact has responded.
  - body: { email?: string, domain?: string }
- `POST https://api.mcp.ai/api/reply/move/contacts/to/lists` — Tool to move one or more contacts to specified lists. Use when reorganizing contacts across lists after verifying contact and list IDs.
  - body: { ListIds: integer[], ContactIds: integer[] }
- `POST https://api.mcp.ai/api/reply/remove/domain/from/blacklist` — Tool to remove the specified domain from the blacklist. Use when you need to allow sending to that domain again.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/reply/search/contacts` — Tool to search contacts by email. Use when you need to find existing contact IDs for update tests.
  - body: { email: string }

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

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