# Get started with HeyLead

> 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.

This file is the quickstart for a person or an agent. The full agent document is https://heylead.dev/llms.txt; the tool reference is https://heylead.dev/llms-full.txt.

## The one-line setup

Paste this into Claude Code or your AI chat:

```
Set up HeyLead using https://heylead.dev/llms.txt
```

Your AI follows the setup for your client. The hosted connection needs no Python, uv or API key. Nothing is sent to anyone during setup.

## Per client

### Claude Code, terminal

```sh
claude mcp add --transport http --scope user heylead https://heylead.dev/mcp
```

Then open `/mcp`, select heylead and sign in in the browser. If the server is not listed, start a new session and open `/mcp` again.

### Claude Code desktop, without the CLI

If `claude` is not on PATH, paste the one-line setup into the Code tab. Your agent adds the remote server to your Claude Code configuration, keeping your existing settings. Start a new session, open `/mcp` and sign in.

### Claude Desktop chat, Cowork and claude.ai

Open Customize → Connectors (or Settings → Connectors), choose **Add custom connector**, and enter:

```
https://heylead.dev/mcp
```

Click Add, then Connect, complete the browser sign-in and enable HeyLead in your conversation.

### Cursor

Merge this into `.cursor/mcp.json` (or `~/.cursor/mcp.json` for every project), keeping your other servers:

```json
{"mcpServers": {"heylead": {"url": "https://heylead.dev/mcp"}}}
```

Enable the server in Cursor's MCP settings and sign in.

### Any other MCP client

Remote Streamable HTTP at `https://heylead.dev/mcp` with OAuth browser sign-in. Discovery: https://heylead.dev/.well-known/oauth-protected-resource and https://heylead.dev/.well-known/oauth-authorization-server.

### No MCP client

Sign in at https://heylead.dev/dashboard/login. The dashboard runs the same campaigns.

## Verify, then the first campaign

1. Sign in with Google when your client opens HeyLead in the browser.
2. Connect LinkedIn in the dashboard at https://heylead.dev/dashboard/. HeyLead never sees your LinkedIn password.
3. Ask your AI: "Show my HeyLead status." It should call `show_status` and report your workspace, even if it is empty. A saved configuration is not a connection; a tool call that answers is.
4. Describe what you sell and who you want to reach. `generate_icp` returns two to four buyer personas; `create_campaign` finds matching people and saves a draft. Nothing is sent.
5. Read the draft. Outreach starts only with `campaign(action="launch")`, and a new workspace holds opening messages and follow-ups for your approval. Invitations are not held.

## What it costs

- Free: $0, up to 2 follow-ups per prospect
- Pro: $29 per connected LinkedIn account per month, up to 5 follow-ups per prospect
- Invitation limits follow the LinkedIn account (free, Premium or Sales Navigator), not the HeyLead plan.
- Self-hosted free installs have monthly quotas: 50 invitations, 20 messages, 30 engagements, 1 active campaign, 3 ICP generations.

HeyLead is not affiliated with LinkedIn. It reaches LinkedIn through Unipile, which is also not affiliated. LinkedIn's User Agreement prohibits automated messaging and may restrict an account; HeyLead's pacing lowers that risk and does not remove it.

## More

- Site: https://heylead.dev
- What is HeyLead: https://heylead.dev/what-is-heylead
- LinkedIn MCP server: https://heylead.dev/linkedin-mcp-server
- Source on GitHub (MIT client): https://github.com/D4umak/linkedin-outreach-mcp
- Privacy: https://heylead.dev/privacy · Terms: https://heylead.dev/terms