# Heyreach — MCP server on mcp.ai
> Connect your Heyreach account and use 19 tools for marketing automation straight from your AI agent. Connect with your own API key. HeyReach is a multichannel outreach platform designed to help businesses and professionals engage with their audience effectively.

By: mcp.ai · official
Page: https://mcp.ai/heyreach

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_heyreach?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/heyreach/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/heyreach/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/heyreach/skill.md
Postman collection (v2.1): https://mcp.ai/heyreach/postman.json

## Tools
- heyreach_add_leads_to_list_v2(leads: object[], listId: integer) — Tool to add leads to a lead list in HeyReach for LinkedIn campaigns. Accepts up to 100 leads per request and returns counts of added, updated, and failed leads.
- heyreach_check_api_key() — Tool to check if the API key is valid. Use before making other API calls to confirm authentication.
- heyreach_create_empty_list(name: string, type?: string) — Tool to create an empty list. Use after deciding on the list name and type.
- heyreach_create_tags(tags: object[]) — Tool to create one or multiple tags for your workspace. Use when you need to organize leads with custom labels.
- heyreach_create_webhook(eventType: string, webhookUrl: string, campaignIds?: integer[], webhookName: string) — Tool to create a new webhook. Use when you need programmatic callbacks for HeyReach events after confirming a valid API key.
- heyreach_delete_webhook(webhookId: string) — Tool to delete an existing webhook. Use when you need to remove callbacks for outdated or unwanted webhooks.
- heyreach_get_all_campaigns(limit?: integer, offset?: integer, keyword?: string, statuses?: string[], accountIds?: integer[]) — Tool to retrieve all campaigns. Use when you need a paginated list of campaigns for management or reporting.
- heyreach_get_all_leads(limit?: integer, listId: integer, offset?: integer, keyword?: string, createdTo?: string, createdFrom?: string, leadLinkedInId?: string, leadProfileUrl?: string) — Tool to retrieve all leads in a HeyReach list. Use when you need paginated collection of leads after confirming a valid API key.
- heyreach_get_all_linkedin_accounts(limit?: integer, offset?: integer, keyword?: string) — Tool to retrieve all LinkedIn accounts. Use when you need a paginated list of LinkedIn accounts after confirming a valid API key.
- heyreach_get_all_lists(limit?: integer, offset?: integer) — Tool to retrieve all lists. Use when you need a paginated list of lists after confirming a valid API key.
- heyreach_get_all_webhooks(limit?: integer, offset?: integer) — Tool to retrieve all webhooks. Use when you need a paginated collection of webhooks after confirming a valid API key.
- heyreach_get_companies_from_list(limit?: integer, listId: integer, offset?: integer, keyword?: string) — Tool to get companies from a company list. Use when you need a paginated list of companies after specifying a list ID.
- heyreach_get_conversations_v2(limit?: integer, offset?: integer, filters: object) — Tool to retrieve paginated LinkedIn conversations with advanced filters. Use when you need to fetch inbox conversations filtered by lead or profile details.
- heyreach_get_lead(profileUrl: string) — Tool to retrieve detailed information for a lead by profile URL. Use after obtaining the exact LinkedIn profile URL to fetch full lead details.
- heyreach_get_lists_for_lead(limit?: integer, offset?: integer, profileUrl: string) — Tool to retrieve all lists that contain a specific lead by profile URL. Use when you need to find which lists a lead belongs to.
- heyreach_get_my_network_for_sender(pageSize: integer, senderId: integer, pageNumber: integer) — Tool to get the LinkedIn network for a specified sender account. Use when you need to retrieve paginated connections for a sender.
- heyreach_get_overall_stats(dateTo?: string, dateFrom?: string, accountIds?: integer[], campaignIds?: integer[]) — Tool to get overall statistics for LinkedIn accounts and campaigns. Use when you need performance metrics including connection requests, messages, replies, and engagement rates for specified date rang
- heyreach_get_webhook_by_id(webhookId: integer) — Tool to retrieve a webhook by its ID. Use when you need detailed configuration of a specific webhook after listing or creating it.
- heyreach_update_webhook(isActive?: boolean, eventType?: string, webhookId: string, webhookUrl?: string, campaignIds?: integer[], webhookName?: string) — Tool to update an existing webhook’s configuration. Use when you need to modify a webhook's name, URL, event type, campaigns, or activation status after confirming the webhookId.

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

## Links
Docs: https://mcp.ai/docs/mcps/heyreach
Website: https://mcp.ai/mcps/heyreach