HeyLead docs

HeyLead is an AI agent for LinkedIn outreach: it finds the right people, writes to them in the voice of your own LinkedIn posts, follows up, and handles replies. It runs from Claude Code, Cursor, any MCP client or a web dashboard.

These pages are for the person setting it up and for the agent doing it on their behalf. Every page here has a plain-text twin: add .md to the address, or ask for text/markdown.

Start here

• Quickstart: connect the hosted server from your client, sign in, run the first tool call, draft the first campaign.
• Tool reference: every tool the server registers, which ones only read, and which ones need HEYLEAD_TOOLS=all.
• Authentication: OAuth 2.1 with browser sign-in, the two scopes, how long a token lives, how to revoke it.
• Self-hosting: the MIT client on your own machine with your own Unipile account and LLM key, and its monthly quotas.
• Troubleshooting: the setups that fail most and what to do.
• Glossary: the words you meet, from ICP to autopilot, each naming the tool, page or setting it lives in.

By client

The hosted server is one address, https://heylead.dev/mcp, reached over Streamable HTTP with OAuth browser sign-in. The quickstart shows the exact lines for each client.

• Claude Code: claude mcp add --transport http --scope user heylead https://heylead.dev/mcp, or install the plugin, which adds skills for setting up, starting a campaign, approving messages and answering replies. Quickstart.
• Claude Desktop, Cowork and claude.ai: add https://heylead.dev/mcp as a custom connector. Quickstart.
• ChatGPT: add https://heylead.dev/mcp as a custom MCP app (Plugins → Add → Create MCP App, OAuth). Tested on ChatGPT Pro on 29 September 2026; whether it is offered depends on your ChatGPT plan and settings. Quickstart.
• Cursor: a heylead entry with that URL in .cursor/mcp.json. Quickstart.
• VS Code: the same entry under servers in .vscode/mcp.json. Quickstart.
• Any other MCP client: the remote-server format of that client, never a stdio command entry. Quickstart.
• No MCP client: the web dashboard runs the same campaigns from a browser.

By task

• Reach the first users of something you shipped: one sentence about what you built and who it is for. generate_icp returns 2 to 4 buyer personas grounded in your website; create_campaign saves a draft; nothing is sent until you say launch. Founder-led sales.
• Find a job: goal='job_search' reaches the hiring manager and the team behind a role, and every reply is held for you to answer. Job search.
• Hire, find partners or investors, scout a vendor, recruit interview participants: the same campaign with a different goal and a brief. Use cases.
• Re-engage the people you already know: A connections-only campaign stays inside your first-degree network. Your network.
• See what the agents decided: inspect on any person or campaign reads the journal line by line. Signals, ICP and enrichment.
• Send won deals to HubSpot: crm_sync pushes contacts, deals and the conversation, and pulls closed-won deals back as revenue, from the local client. HubSpot integration.
• Know the ceilings before you start: the invitation ceiling per LinkedIn plan, the profile-read cap, the quiet hours and the backoff, every number from the code. LinkedIn limits.

What sends, and when

create_campaign sends nothing. Outreach starts with campaign(action='launch'), from the cloud, with your laptop closed. Opening messages, follow-ups and answers to replies go out without review unless you switch review on. This is the same on every plan. Sending runs Monday to Friday, 08:00 to 22:00 in your time zone, and no LinkedIn call is made between 22:00 and 08:00. campaign(action='pause') stops one campaign; campaign(action='emergency_stop') stops everything. FAQ: sending, Security.

Plans

Free is $0 with one LinkedIn seat, cloud sending included and two follow-ups per person. It reaches new people until your 2nd hot lead. A hot lead is a person whose reply HeyLead reads as interested. Pro is $29 per connected account per month, with five follow-ups. The ceilings are the LinkedIn account's, not the plan's. Pricing.

For an agent, the shortest path is still one line: paste Set up HeyLead using https://heylead.dev/llms.txt into your chat. The full agent document is llms.txt; the long form with every tool is llms-full.txt.

HeyLead is not affiliated with LinkedIn. It reaches LinkedIn through Unipile, which is also not affiliated.