# HeyReach MCP MCP > HeyReach MCP automates your LinkedIn outreach and lead generation directly through any AI client. It lets you manage entire campaigns, import leads from profile URLs, monitor recent conversations in your inbox, and send personalized messages without leaving your agent's chat window. ## Overview - **Category:** sales-automation - **Price:** Free - **Tags:** linkedin-outreach, campaign-management, prospecting, lead-management, social-selling, automation ## Description You connect this MCP to your preferred AI client to gain full control over your LinkedIn outreach process. Instead of logging into the HeyReach dashboard, you just talk to your agent. It acts like a dedicated B2B Growth Specialist, handling everything from identifying prospects to sending follow-up messages. You can list existing campaigns to see what's running, find detailed information on leads using only their profile URLs, or add groups of new contacts to sequences in bulk. If you need to respond to someone who just messaged you, your agent can access recent conversations and draft a reply right there. This whole process works through Vinkius, letting any compatible AI client use this powerful toolset. ## Tools ### add_leads_to_campaign Adds new leads in a list of profiles to a specified campaign sequence. ### get_lead_details Pulls in full information about a single prospect using their LinkedIn profile URL. ### get_api_profile Checks your API key validity and retrieves basic account details. ### list_linkedin_accounts Lists every connected LinkedIn account available for sending messages. ### list_campaigns Lists all outreach campaigns you have set up. ### list_conversations Shows the most recent conversations from your LinkedIn inbox. ### list_lead_campaigns Displays all campaigns that a specific lead is currently part of. ### pause_campaign Temporarily stops an active outreach campaign. ### resume_campaign Resumes a paused outreach campaign. ### send_linkedin_message Sends a direct message into a specific LinkedIn conversation thread. ## Prompt Examples **Prompt:** ``` List all my active LinkedIn campaigns. ``` **Response:** ``` I've retrieved your campaigns. You have 3 active outreach projects: 'Q2 Tech Founders' (ID: 5501), 'SDR Managers EMEA', and 'VC Partners US'. Which one would you like to check the metrics for? ``` **Prompt:** ``` Add Jane Doe (https://linkedin.com/in/janedoe) to campaign ID 5501. ``` **Response:** ``` Lead added! I've successfully imported Jane Doe into campaign 5501. She will now enter the defined outreach sequence. Should I check if there are any other leads waiting to be added? ``` **Prompt:** ``` Show me the latest conversations from my LinkedIn inbox. ``` **Response:** ``` Accessing inbox... You have 5 recent replies, including messages from 'Mark Thompson' (High interest) and 'Elena Rossi'. Mark says: 'Interesting proposal, let's talk next Tuesday'. Would you like to send a reply to Mark? ``` ## Capabilities ### Manage Campaign Status List all outreach campaigns, or pause/resume them when needed. ### Enrich Lead Data Retrieve detailed prospect information using a LinkedIn profile URL. ### Onboard Prospects to Campaigns Add up to 100 leads in one request, dropping them into the right outreach sequences. ### Communicate via Inbox Access recent LinkedIn conversations and send direct replies from your agent. ### Identify Sender Accounts List all connected LinkedIn accounts to know which profile is currently sending messages. ## Use Cases ### Cold outreach follow-up A BDR just found a high-value lead's profile. Instead of copying the URL into another system, they ask their agent to run `get_lead_details` first. Once verified, they use this data to draft and send a personalized message via `send_linkedin_message`, keeping everything in one chat. ### Resuspending stalled campaigns The SDR notices Campaign XYZ has stopped running because of an internal policy change. They ask the agent to run `list_campaigns` to confirm its ID, and then trigger `resume_campaign`, getting it back into the active sequence immediately. ### Large batch lead intake The Sales Ops team needs to onboard 50 new contacts identified this week. They use the agent to call `add_leads_to_campaign` with a massive JSON list, ensuring all prospects are added and ready for the sequence. ### Monitoring performance across accounts The team lead wants to know if Sender A or Sender B is having better engagement. They run `list_linkedin_accounts` to check all available sender profiles, then monitor activity using `list_conversations`. ## Benefits - Instead of manual bulk uploads, you can add leads to campaigns using the `add_leads_to_campaign` tool. This handles up to 100 prospects in one shot. - Never lose context again. You can use `list_conversations` to access your recent LinkedIn messages and then use `send_linkedin_message` to reply immediately, all from your AI agent. - Need to vet a lead? The `get_lead_details` tool pulls deep prospect data just by giving it the profile URL. It saves you time digging through profiles manually. - Managing multiple client accounts is easy. Use `list_linkedin_accounts` to see every sender profile and know exactly which account is driving the conversation flow. - Campaign control means staying on top of timing. You can use `pause_campaign` or `resume_campaign` instantly, letting you adjust sequences without touching the web dashboard. ## How It Works The bottom line is, your AI client handles all the API calls; you just give natural language instructions. 1. First, connect your HeyReach API key through Vinkius and authenticate your AI client. 2. Next, direct your agent to perform an action, like listing campaigns or pulling lead details from a profile URL. 3. The MCP executes the request, returns the data (e.g., campaign IDs, prospect info), and you tell your agent what to do with it. ## Frequently Asked Questions **How do I find my HeyReach API Key?** Log in to your HeyReach account, navigate to **Settings**, and you will find your unique **API Key** in the API section. Ensure you have the necessary administrative permissions. **Can I add leads to a campaign that hasn't been launched?** No, campaigns must be launched at least once in the HeyReach web interface before you can add leads to them via the API or this integration. **How many leads can I add in one request?** The `add_leads_to_campaign` tool supports adding up to 100 leads in a single batch request to ensure optimal performance and adherence to rate limits. **Is the integration secure for my LinkedIn data?** Absolutely. The integration uses official HeyReach API keys over HTTPS. Your credentials and LinkedIn access tokens are encrypted and stored securely within the Vinkius Cloud infrastructure. **How do I use the `list_lead_campaigns` tool to check if a prospect is in multiple outreach sequences?** The tool returns every campaign ID associated with that specific lead. This helps you confirm exactly where a person is being targeted, preventing conflicting messaging or missed context during your manual review. **Before using the `send_linkedin_message` tool, how do I find the necessary conversation ID?** You must first run `list_conversations`. This command retrieves recent chat history, giving you the unique IDs needed to target a specific thread for messaging. **Using `list_linkedin_accounts`, how do I verify which profile should send the message?** It provides a list of all connected sending accounts. This is essential for multi-user teams, ensuring that outreach messages always originate from the correct and authorized sender profile. **If I need to temporarily stop an active campaign, what's the process using `pause_campaign`?** You simply call `pause_campaign` with the campaign ID. Later, you can resume the entire sequence by calling `resume_campaign`, keeping your workflow visible without needing manual dashboard intervention.