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.
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.
#Connect it
Open Settings, Integrations, then the MCP server tile
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.
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.
Paste the line or JSON it shows, with your key in place of
YOUR_API_KEYFor Claude Code it's one line in a terminal. For the others, add the JSON to the settings file named above the code.
Restart the assistant if it asks
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 see | What to do |
|---|---|
401 or unauthenticated | The key is missing, mistyped or revoked. The header must read Bearer, a space, then the key. |
No launch_campaign tool | That'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 time | Wait for the time given. |
A 405 that says the server isn't available | Use 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.