# HeyReach MCP for AI Agents AI Agent Connect > HeyReach lets you manage your LinkedIn outreach directly through an AI agent. You can create campaigns, import leads, and handle inbox replies without leaving your chat interface. It connects your HeyReach account to tools like Claude or Cursor so you can run your B2B sales sequences from a single prompt. ## Overview - **Category:** sales-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_NoaWV6kGAgtXSV60szbsWyLYTJHHIpT2CulXsysJ/ai-agent-connect - **Tags:** linkedin-outreach, campaign-management, prospecting, lead-management, social-selling, automation ## Description HeyReach lets you run your LinkedIn outreach from a chat window instead of juggling multiple browser tabs. If you're tired of jumping back and forth between your lead list and the HeyReach dashboard, this Connector changes that. You can tell your agent to pull in a batch of new prospects, check which campaigns they belong to, or even send a reply to a hot lead in your inbox. It turns your agent into a dedicated sales ops person that handles the heavy lifting of data entry and campaign monitoring. Because Vinkius makes it so easy to connect these types of tools, you can move from manual data entry to high-level strategy in a few minutes. You get to focus on closing deals while your agent keeps the outreach moving. ## Tools ### add_leads_to_campaign Import new leads into a specific campaign using a JSON string of profile data. It handles high-throughput requests for up to 100 leads at a time. ### get_lead_details Fetch full prospect information from a LinkedIn profile URL. Use this to enrich your data before starting a sequence. ### get_api_profile Check if your API key is valid and see your basic account info. It's the first thing you do to make sure the connection works. ### list_linkedin_accounts See all the LinkedIn profiles connected to your workspace. This helps you identify which sender is currently active. ### list_campaigns Find the unique IDs for your outreach projects. You need these IDs to manage status or add new leads. ### list_conversations Pull the latest messages from your LinkedIn inbox. Use this to see what your prospects are saying in real time. ### list_lead_campaigns See every campaign a specific lead is enrolled in. This prevents you from double-messaging the same person. ### resume_campaign Restart a paused campaign. Use this to get your outreach back on track after a scheduled break. ### pause_campaign Stop an active LinkedIn sequence instantly. This is useful if you need to take a break or fix a campaign error. ### send_linkedin_message Send a direct reply to a conversation. Just provide the conversation ID and the text you want to send. ## Prompt Examples **Prompt:** ``` Show me all my active LinkedIn campaigns. ``` **Response:** ``` I've pulled your active campaigns from HeyReach. Here is what's currently running: | Campaign Name | ID | Status | | :--- | :--- | :--- | | Q3 Tech Founders | 5501 | Active | | SDR Managers EMEA | 5502 | Active | | VC Partners US | 5503 | Active | Which one would you like to manage? ``` **Prompt:** ``` Add this person (https://linkedin.com/in/jdoe) to my Tech Founders campaign. ``` **Response:** ``` I've successfully added Jane Doe to your **Tech Founders** campaign (ID: 5501). She's now in the sequence. Would you like me to check if there are any other leads to add? ``` **Prompt:** ``` What are the latest messages in my inbox? ``` **Response:** ``` Checking your LinkedIn inbox now... **Recent Conversations:** * **Mark Thompson**: "Interesting proposal, let's talk next Tuesday." * **Elena Rossi**: "Can you send over more details?" Would you like me to draft a reply to Mark or Elena? ``` ## Capabilities ### Add leads to campaigns Import a list of prospects into a specific outreach sequence in one go. ### Pause active campaigns Stop a sequence immediately to prevent unwanted messages. ### Resume paused campaigns Restart an outreach sequence once you're ready to go again. ### Get lead details Pull full prospect information from a LinkedIn profile URL. ### Send LinkedIn messages Reply to an existing conversation directly from your chat. ### List connected accounts See every LinkedIn profile currently linked to your workspace. ### List outreach campaigns View all your active and paused sequences to find specific IDs. ### List lead campaigns Check which specific sequences a lead is currently enrolled in. ### List inbox conversations See recent messages and replies from your LinkedIn leads. ### Check API status Verify your account connection and basic profile info. ## Use Cases ### The Agency Workflow An agency owner needs to move 50 leads into a new campaign. They ask the agent to use add_leads_to_campaign for a specific ID. ### The SDR Research An SDR finds a target on LinkedIn and asks the agent to get_lead_details. The agent then adds them to the High Priority campaign. ### The Inbox Manager A sales manager asks the agent to list_conversations. They see a Yes from a prospect and use send_linkedin_message to book a meeting. ### The Campaign Auditor A user wants to see if a lead is in any other sequences. They use list_lead_campaigns to ensure they aren't sending duplicate messages. ## Benefits - Stop manual data entry by using add_leads_to_campaign to bulk import prospects into your sequences. - Manage multiple clients easily by using list_linkedin_accounts to switch between different sender profiles. - Prevent message fatigue by using list_lead_campaigns to check a lead's status before you reach out. - React faster to hot leads by using list_conversations to see recent replies and send_linkedin_message to reply. - Maintain total control over your volume by using pause_campaign and resume_campaign to manage active sequences. - Verify your connection instantly with get_api_profile to ensure your outreach never hits a technical snag. ## How It Works The bottom line is you get a hands-off way to manage your entire LinkedIn sales pipeline through a single chat interface. 1. Subscribe to the HeyReach MCP on Vinkius. 2. Paste your HeyReach API key into your AI client settings. 3. Ask your agent to list campaigns or add leads to start your outreach. ## Frequently Asked Questions **Can I use HeyReach to automate my LinkedIn messages?** Yes, you can use this Connector to send direct replies to conversations from your chat interface. It allows your agent to handle the communication flow without you having to open the LinkedIn website. **How do I add leads to a campaign using this Connector?** You can simply tell your agent to add a list of leads to a specific campaign. The agent will handle the data import for you, supporting high-volume requests of up to 100 leads at once. **Can I manage multiple LinkedIn accounts at once?** Yes, the Connector allows you to list and identify all LinkedIn accounts connected to your workspace. This is ideal for agencies managing multiple client profiles. **How do I see which campaigns a prospect is in?** You can ask your agent to check a specific lead's campaign status. It will retrieve all the sequences that lead is currently enrolled in to help you avoid duplicate outreach. **Can I pause my outreach if I need a break?** Absolutely. You can tell your agent to pause any active campaign immediately. You can also resume it whenever you're ready to restart your outreach. **Is it possible to reply to messages directly?** Yes, you can view recent conversations and send replies directly through your AI client. It makes responding to hot leads much faster since you don't have to switch apps. **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.