Skip to content

Use HeyLeads from Claude, Cursor or VS Code (MCP)

Let an AI assistant read your campaigns and add leads, using a key you control. Nothing sends straight away.

3 min read · Updated November 18, 2026

MCP is a standard way for AI assistants to use outside tools. Connected, you can ask things like which campaigns got the most replies this month? or add these ten people to my Q4 list. The assistant uses a private key you control, and sees only what that key allows.

Settings, Integrations, MCP server.

#Connect it

  1. Open Settings, Integrations, then the MCP server tile

  2. Under Make a key for the assistant, choose Create a key for this

    It's a Member key named MCP assistant. Copy it now; it's shown once.

  3. Under Add it to your assistant, pick your tool's tab

    Claude Code, Claude Desktop, Cursor or VS Code. The code shown already has your address in it.

  4. Paste the line or JSON it shows, with your key in place of YOUR_API_KEY

    For Claude Code it's one line in a terminal. For the others, add the JSON to the settings file named above the code.

  5. Restart the assistant if it asks

Claude Code
claude mcp add --transport http heyleads https://app.heyleads.so/api/v1/mcp --header "Authorization: Bearer YOUR_API_KEY"

#Check it works

Start a new chat and ask: Using HeyLeads, list my campaigns. A list of your real campaigns means you're connected. Then try a read-only follow-up, such as How many leads replied in the last 30 days?

#What the assistant can see and do

  • Which tools it sees depends on the key. A read-only key never sees launch or write tools. A Member key can create and edit campaigns and add leads, but not launch one.
  • Nothing is sent straight away. There's no "send a message now" tool. Adding leads or launching a campaign queues work, which then follows your daily limits and working hours.
  • Not offered: creating webhooks, replying to conversations, marking them read, connecting a LinkedIn account and searching LinkedIn. Do those in the app.
  • The same limits as the API apply: 60 reads, 20 writes and 5 LinkedIn-starting calls per minute.

#If something goes wrong

What you seeWhat to do
401 or unauthenticatedThe key is missing, mistyped or revoked. The header must read Bearer, a space, then the key.
No launch_campaign toolThat's by design on Member and read-only keys. Launch from the app, or use an Admin key with care.
rate limited, with a wait timeWait for the time given.
A 405 that says the server isn't availableUse a client that supports the Streamable HTTP style.

To disconnect, remove the server from your assistant (in Claude Code, claude mcp remove heyleads) and revoke the MCP assistant key under Settings, Integrations, HeyLeads API. Developers can read the technical guide.

Was this article helpful?