Marketing

HeyReach MCP Server

Use Studio chat to drive this server — credentials stay in your workspace.

HeyReach is a LinkedIn automation and outreach platform for agencies and sales teams. Manage campaigns, lead lists, LinkedIn sender accounts, tags, stats, and multi-account sending through the public API. Authentication is a non-expiring API key per organization.

25 tools
Agent guide included
API Key
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for HeyReach — workflow patterns, data models, and gotchas for your AI agent.

HeyReach

HeyReach is LinkedIn-focused outbound: campaigns, lead lists, sender account rotation, tagging, and analytics. The HTTP API is organization-scoped via a static API key.

Data Model

  • Campaigns — LinkedIn outreach sequences with status (DRAFT, IN_PROGRESS, PAUSED, FINISHED, etc.), progress stats, and linked sender accounts. List, get by id, pause/resume, add leads, stop leads, find campaigns for a lead.
  • Lists — Lead lists (USER_LIST) or company lists (COMPANY_LIST). Create, get by id, add leads in bulk (100/request), delete leads by id or profile URL, find lists for a lead.
  • Leads — LinkedIn profiles stored in lists. Look up by profile URL for full profile data (name, company, position, location, image, enriched email). Must be imported into HeyReach via a list first.
  • Tags — Free-text labels on leads. Add (append), replace (destructive overwrite), or read tags. Identify leads by profile URL or LinkedIn numeric ID.
  • LinkedIn Accounts — Sender accounts connected to the org. List all or get by id. Shows active status, auth validity, campaign count, Sales Navigator / Recruiter flags.
  • Stats — Aggregate outreach metrics by sender accounts, campaigns, and date range. Daily and overall: profile views, messages, InMail, connections, reply rates, acceptance rates.

Gotchas

  • Auth header: X-API-KEY on every request.
  • Rate limit: 300 requests per minute org-wide; HTTP 429 when exceeded.
  • POST for listing: Campaign and list listing endpoints use POST with a JSON body (offset, limit, filters), not GET with query params.
  • List type matters: GetLeadsFromList only works on USER_LIST; GetCompaniesFromList only on COMPANY_LIST. Wrong type returns HTTP 400.
  • AddLeadsToListV2: Max 100 leads per request. Each lead needs at least linkedInUrl.
  • AddLeadsToCampaign: Campaign must NOT be in DRAFT status. Pause or start the campaign first.
  • Pause/Resume: Only works on campaigns in the correct status (IN_PROGRESS for pause, PAUSED for resume).
  • StopLeadInCampaign: The lead must be present in the campaign. Check with get_leads_from_campaign first.
  • Tags: lead/AddTags appends; lead/ReplaceTags overwrites all tags. Both need leadProfileUrl or leadLinkedInId. lead/GetTags uses profileUrl or linkedInId.
  • Delete leads: list/DeleteLeadsFromList uses leadMemberIds (integer ids from list membership). list/DeleteLeadsFromListByProfileUrl uses profileUrls (LinkedIn URLs).

Tools in this Server (25)

Heyreach Add Leads To Campaign

Add up to 100 leads to a campaign (V2 endpoint). The campaign must NOT be in DRAFT status — pause or start it first. Each lead is paired with a Linked...

Heyreach Add Leads To List

Add up to 100 leads to an existing HeyReach USER_LIST. Each lead needs at least a linkedInUrl. Returns counts of added, updated, and failed leads. Cre...

Heyreach Add Tags To Lead

Add tags to a lead without removing existing tags. The lead must exist in HeyReach. Identify by lead_profile_url or lead_linkedin_id (provide at least...

Heyreach Check Api Key

Validate the stored HeyReach API key against the service. Returns HTTP 200 when the key is accepted. Use when credentials were just added or when anot...

Heyreach Create List

Create a new empty lead or company list in HeyReach. Returns the created list object with its id, name, and type. Add leads afterward with heyreach_ad...

Heyreach Delete Leads By Url

Delete leads from a list by their LinkedIn profile URLs. Returns a list of URLs that were not found in the list. This removes them from the list only ...

Heyreach Delete Leads From List

Delete specific leads from a list by their member ids. This removes them from the list only — it does not delete the lead from HeyReach. Get lead memb...

Heyreach Get Campaign

Load one HeyReach campaign by id with full detail including status, progress statistics, exclusion settings, and linked list info. Get campaign ids fr...

Heyreach Get Campaigns For Lead

Find all campaigns that include a specific lead. Identify the lead by profile_url, linkedin_id, or email (provide at least one). Returns campaign name...

Heyreach Get Companies From List

Retrieve paginated companies from a HeyReach company list (COMPANY_LIST). Get list ids from heyreach_list_lists — only COMPANY_LIST type lists work he...

Heyreach Get Lead

Look up a single lead by LinkedIn profile URL. Returns full profile data: name, company, position, location, summary, image URL, LinkedIn ID, and enri...

Heyreach Get Leads From Campaign

Retrieve paginated leads from a specific campaign with their campaign-level status (PENDING, IN_PROGRESS, FINISHED, etc.). Optionally filter by status...

Heyreach Get Leads From List

Retrieve paginated leads from a HeyReach lead list (USER_LIST). Returns lead LinkedIn profile data, name, and engagement status. Get list ids from hey...

Heyreach Get Linkedin Account

Get detailed information about a single LinkedIn sender account by id. Returns email, name, active status, auth validity, profile URL, active campaign...

Heyreach Get List By Id

Get detailed information about a specific list including name, type, item count, creation time, and associated campaign ids. Get list ids from heyreac...

Heyreach Get Lists For Lead

Find all lists that contain a specific lead. Identify the lead by profile_url or linkedin_id (provide at least one). Returns list names, types, and id...

Heyreach Get Overall Stats

Get overall outreach statistics for specified sender accounts and date range. Returns daily and aggregate counts for: profile views, post likes, follo...

Heyreach Get Tags For Lead

Retrieve all tags associated with a lead. Identify the lead by profile_url or linkedin_id (provide at least one). Returns an array of tag strings.

Heyreach List Campaigns

List HeyReach LinkedIn outreach campaigns with pagination and filtering. Returns campaign id, name, status, creation time, progress stats (total, in-p...

Heyreach List Linkedin Accounts

List all LinkedIn sender accounts connected to the HeyReach organization. Returns account id, name, email, profile URL, active status, number of activ...

Heyreach List Lists

List all lead and company lists in the HeyReach organization with pagination. Returns list id, name, lead count, list type (USER_LIST or COMPANY_LIST)...

Heyreach Pause Campaign

Pause a running HeyReach campaign. The campaign must be in IN_PROGRESS or STARTING status. Pausing stops all outreach actions but preserves the campai...

Heyreach Replace Tags

Replace ALL existing tags on a lead with a new set. This is destructive — all previous tags are removed. Pass an empty array to clear all tags. Use he...

Heyreach Resume Campaign

Resume a paused HeyReach campaign. The campaign must be in PAUSED status. Resumes outreach actions from where they were paused.

Heyreach Stop Lead In Campaign

Stop a specific lead's progression in a campaign. The lead will not receive any further sequence steps. Useful for removing a lead that replied outsid...

Frequently Asked Questions

What is the HeyReach MCP server?

HeyReach is a LinkedIn automation and outreach platform for agencies and sales teams. Manage campaigns, lead lists, LinkedIn sender accounts, tags, stats, and multi-account sending through the public API. Authentication is a non-expiring API key per organization. It provides 25 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect HeyReach to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/heyreach. Authentication is handled automatically.

How many tools does HeyReach provide?

HeyReach provides 25 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does HeyReach require?

HeyReach uses API Key. HeyReach requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect HeyReach to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/heyreach

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to chat with HeyReach?

Same flow: Studio opens on this server after sign-in. Keep chatting to call tools from the conversation.

HeyReach MCP Server & Skill — 25 Tools