HeyReach MCP Server

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...

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...

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...

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...

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

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 ...

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. Copy lead mem...

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

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...

Retrieve paginated companies from a HeyReach company list (COMPANY_LIST). Copy list ids from an organization lists response — only COMPANY_LIST type l...

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

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

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

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

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

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...

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

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.

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

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

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)...

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

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. Append...

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

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...