How to Use the HeyReach MCP in VS Code Copilot

Q: How can my team use HeyReach and VS Code Copilot together?

Set up the HeyReach MCP Server in a shared .vscode/mcp.json file in your project's repository. This gives everyone on the team access to the same tools, like listcampaigns and sendlinkedinmessage, directly within Copilot chat.

Q: How do I configure the HeyReach tools for everyone on my team in VS Code Copilot?

Create a file named mcp.json inside the .vscode folder at your project root. Add the HeyReach server configuration there and commit it to Git. When your teammates pull the changes, VS Code will automatically detect and enable the tools for them.

Give your entire team shared access to HeyReach automation inside VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HeyReach MCP to VS Code Copilot

Create your Vinkius account to connect HeyReach to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HeyReach with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

A shared config for your whole team

Here's the thing: you can commit a `.vscode/mcp.json` file to your repository. Once you do, every developer on your team who pulls the repo gets instant access to this HeyReach toolset in their VS Code Copilot. No more individual setup. Everyone on the team can use the agent to `list_campaigns` or check which sender profiles are active with `list_linkedin_accounts`. It puts everyone on the same page with the same data, instantly.

Define roles with code

Your team can now work together on outreach. A sales ops manager can use their VS Code instance to set up campaigns and then commit the code. A sales rep can then pull the latest, open Copilot, and tell the agent, 'use `add_leads_to_campaign` to add my new prospects to the latest campaign.' It creates a clear workflow. The agent uses tools like `get_lead_details` to provide context, and your team works from a single source of truth. This is how you manage sales automation at scale.

Build internal oversight tools

Because this HeyReach MCP Server is available in VS Code, your engineering team can quickly build internal tools for the sales team. They can write a simple script that uses `list_conversations` and `list_lead_campaigns` to create a daily report on outreach activity. This isn't just about asking the agent questions. It's about using the agent to write code that provides ongoing value. Your team can build, test, and deploy small, helpful apps that connect directly to your live HeyReach data, all from the editor they already use.

Setup guide

Set up HeyReach MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the HeyReach MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the HeyReach tools listed. Try asking: "List my recent HeyReach transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "heyreach-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HeyReach. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HeyReach now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HeyReach MCP in VS Code Copilot

Set up the HeyReach MCP Server in a shared `.vscode/mcp.json` file in your project's repository. This gives everyone on the team access to the same tools, like `list_campaigns` and `send_linkedin_message`, directly within Copilot chat.

Create a file named `mcp.json` inside the `.vscode` folder at your project root. Add the HeyReach server configuration there and commit it to Git. When your teammates pull the changes, VS Code will automatically detect and enable the tools for them.

Yes. Once configured, you can instruct the Copilot agent to perform lead operations. For example, you can tell it to use `add_leads_to_campaign` by providing a JSON of lead data, or look up someone's details with `get_lead_details`.

You can stick to read-only commands. Just ask the agent things like 'list all active campaigns' (`list_campaigns`) or 'show me the conversation history for this lead' (`list_conversations`). You don't have to use tools that make changes, like `pause_campaign`.

Yes. This server processes specific HeyReach data points: campaign details, lead profile information, and message text. When Copilot calls a tool, that data is handled in an ephemeral, zero-trust sandbox on Vinkius. The connection is secure, and no operational data is permanently stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript