Connect LeadClaw to Claude Desktop & Cursor (MCP)

MCP lets Claude Desktop, Cursor, or any compatible AI tool read your LeadClaw account directly, and on Pro or Ultra, act on it too. Here's how to connect it.

What is MCP?

The Model Context Protocol (MCP) lets AI tools like Claude Desktop and Cursor talk directly to LeadClaw. Once connected, you can ask things like:

• "Show me my campaign stats"
• "What hot leads came in this week?"
• "Pause my outreach campaign"

LeadClaw answers with live data from your account. See below for which of those need Pro or Ultra.

Step 1: generate an API key

1. Go to Settings > API keys.
2. Click Generate key.
3. Copy the key. It starts with lc_sk_.

Keep it private. Anyone who has it can read your LeadClaw data.

Step 2: connect your AI tool

Claude Desktop

Add this to your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "leadclaw": {
      "command": "npx",
      "args": ["-y", "@leadclaw/mcp-server", "--key", "lc_sk_YOUR_KEY"]
    }
  }
}

Restart Claude Desktop and you'll see a LeadClaw icon in the toolbar.

Cursor

Add this to your Cursor MCP settings (Cursor > Settings > MCP):

{
  "leadclaw": {
    "command": "npx",
    "args": ["-y", "@leadclaw/mcp-server", "--key", "lc_sk_YOUR_KEY"]
  }
}

Any streamable HTTP client

POST https://app.leadclaw.io/api/mcp
Authorization: Bearer lc_sk_YOUR_KEY
Content-Type: application/json

Step 3: test it

In Claude Desktop or Cursor, type:

"What are my LeadClaw campaign stats?"

You should see live data back.

What your plan can do

Connecting works on every plan, trial included. What you can actually do once you're connected depends on your tier.

• Reading data (stats, leads, inbox, usage) works everywhere.
• Write actions, creating a campaign, pausing or resuming one, uploading leads, verifying an email, need Pro or Ultra. On a trial, the write command fails with a tier error instead.
• Analytics tools need Ultra specifically.

So on a trial, asking for your campaign stats works fine, but asking your agent to pause a campaign won't, until you upgrade.

Available commands

Once connected, your AI tool has access to more than 30 LeadClaw tools, including:

• Dashboard: leads generated, emails sent, replies, hot leads
• Campaigns: list, get details, create, pause, resume, archive (create, pause, resume, and archive need Pro or Ultra)
• Leads: search, view pipeline, upload, verify an email (uploading and verifying need Pro or Ultra)
• Inbox: read your lead-reply threads. This is read-only. There's no reply-from-MCP tool.
• Usage and plan: check your limits, current usage, and plan comparison
• Reports: pull your weekly performance report
• Content: read your content calendar, assets, and post analytics (Pro and Ultra)

Revoking access

Go to Settings > API keys and click Revoke next to any key to cut off access immediately.