# ManyReach — how to use (mcp.ai)

Connect your ManyReach account and use 16 tools for email straight from your AI agent. Connect with your own API key. ManyReach is a cold email outreach platform for managing campaigns, prospects, senders, messages, and workspaces.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/manyreach/create/campaign` — Create and save a new draft campaign's configuration. This tool is draft-only: it does not start, pause, archive, or otherwise activate outreach, and it never sends email.
  - body: { name: string, subject?: string, body_html?: string, folder_id?: integer, from_name?: string, daily_limit?: integer, description?: string, track_opens?: boolean, track_clicks?: boolean, sender_emails?: string[], reply_to_email?: string, daily_limit_per?: string, schedule_sending?: boolean, text_only_emails?: boolean, delay_min_minutes?: integer, schedule_time_zone?: string, use_prospects_time_zone?: boolean }
- `POST https://api.mcp.ai/api/manyreach/create/list` — Create a ManyReach mailing list.
  - body: { title: string, folder_id?: integer }
- `POST https://api.mcp.ai/api/manyreach/create/prospect` — Create one ManyReach prospect. sending_active controls whether the prospect is eligible for campaign sending and safely defaults to false. This tool only saves the prospect; it does not start a campai
  - body: { city?: string, email: string, notes?: string, phone?: string, state?: string, domain?: string, company?: string, country?: string, website?: string, industry?: string, location?: string, last_name?: string, first_name?: string, icebreaker?: string, base_list_id?: integer, company_size?: string, job_position?: string, custom_fields?: object, company_social?: string, sending_active?: boolean, sending_status?: string, personal_social?: string }
- `POST https://api.mcp.ai/api/manyreach/create/tag` — Create a CRM, campaign, or sender tag.
  - body: { title: string, tag_type?: string, description?: string }
- `POST https://api.mcp.ai/api/manyreach/delete/outreach/resource` — Permanently and irreversibly delete exactly one campaign, prospect, mailing list, or tag by ID. This cannot be undone. The tool rejects the request unless confirm_deletion=true after explicit caller c
  - body: { resource_id: integer, resource_type: string, confirm_deletion: boolean, force_tag_delete?: boolean }
- `POST https://api.mcp.ai/api/manyreach/get/account/overview` — Return the authenticated ManyReach organization together with its sending-credit and data-token balances.
- `POST https://api.mcp.ai/api/manyreach/list/campaigns` — Find campaigns in the authenticated organization, optionally filtering by lifecycle status or archived state. Returns one page at a time.
  - body: { limit?: integer, cursor?: string, status?: string, include_archived?: boolean }
- `POST https://api.mcp.ai/api/manyreach/list/lists` — Return one page of mailing lists available for organizing and importing prospects.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/manyreach/list/messages` — Retrieve one read-only page of reply, sent, or manually sent messages with campaign, followup, sender, CRM-status, address, and subject filters. This action does not reply to or send messages.
  - body: { limit?: integer, cursor?: string, subject?: string, email_to?: string, sender_id?: integer, email_from?: string, campaign_id?: integer, followup_id?: integer, message_type: string, confirmed_status?: string }
- `POST https://api.mcp.ai/api/manyreach/list/prospects` — Search and filter prospects by identity, CRM status, tags, campaign membership, and existing email-validation verdict. Returns one page at a time.
  - body: { tags?: string[], email?: string, limit?: integer, cursor?: string, search?: string, status?: string, validation_status?: string, exclude_campaign_ids?: integer[], include_campaign_ids?: integer[] }
- `POST https://api.mcp.ai/api/manyreach/list/senders` — Find configured sender mailboxes by folder, connection status, warmup state, or search text. Returns one page without exposing mailbox credentials.
  - body: { limit?: integer, cursor?: string, folder?: string, search?: string, status?: string, warmup?: boolean }
- `POST https://api.mcp.ai/api/manyreach/list/tags` — Find CRM, campaign, or sender tags and optionally include prospect counts. Returns one page at a time.
  - body: { limit?: integer, cursor?: string, search?: string, tag_type?: string, include_prospect_count?: boolean }
- `POST https://api.mcp.ai/api/manyreach/update/campaign` — Update an existing draft campaign's configuration. This tool is draft-only: it does not start, pause, archive, or otherwise activate outreach, and it never sends email.
  - body: { name?: string, subject?: string, body_html?: string, folder_id?: integer, from_name?: string, campaign_id: integer, daily_limit?: integer, description?: string, track_opens?: boolean, track_clicks?: boolean, sender_emails?: string[], reply_to_email?: string, daily_limit_per?: string, schedule_sending?: boolean, text_only_emails?: boolean, delay_min_minutes?: integer, schedule_time_zone?: string, use_prospects_time_zone?: boolean }
- `POST https://api.mcp.ai/api/manyreach/update/list` — Rename or move an existing ManyReach mailing list.
  - body: { title?: string, list_id: integer, folder_id?: integer }
- `POST https://api.mcp.ai/api/manyreach/update/prospect` — Update contact, personalization, list, CRM, or campaign-sending eligibility fields for one ManyReach prospect by ID. The prospect email cannot be changed. This tool does not send email.
  - body: { city?: string, notes?: string, phone?: string, state?: string, domain?: string, company?: string, country?: string, website?: string, industry?: string, location?: string, last_name?: string, first_name?: string, icebreaker?: string, prospect_id: integer, base_list_id?: integer, company_size?: string, job_position?: string, custom_fields?: object, company_social?: string, sending_active?: boolean, sending_status?: string, personal_social?: string }
- `POST https://api.mcp.ai/api/manyreach/update/tag` — Update an existing tag's title and description. A tag's resource class cannot be changed after creation.
  - body: { title?: string, tag_id: integer, description?: string }

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

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