Docs
Connect LeadVibe to Claude, Cursor, and other MCP clients
LeadVibe exposes a Model Context Protocol (MCP) server so any compatible AI assistant can read your leads, update their pipeline status, manage monitors, and generate fresh AI drafts on your behalf.
Step 1 — Generate an API key
API keys are required to authenticate MCP clients. They're scoped to your account and Pro plan is required.
- Go to Settings → API Keys.
- Click New key and give it a name (e.g. "Claude Desktop").
- Copy the key immediately — it's shown only once. Format:
lv_live_….
Step 2 — Note your MCP endpoint
Your MCP server lives at:
https://YOUR-DEPLOYMENT.convex.site/mcp
Step 3a — Configure Claude Desktop
Claude Desktop currently bridges remote MCP servers via the mcp-remote adapter. Edit your config:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"leadvibe": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://YOUR-DEPLOYMENT.convex.site/mcp",
"--header",
"Authorization:Bearer YOUR_API_KEY"
]
}
}
}Replace YOUR_API_KEY with the key you copied. Restart Claude Desktop after saving.
Step 3b — Configure Cursor
Cursor supports HTTP MCP servers natively. Open Cursor's settings JSON and add:
{
"mcpServers": {
"leadvibe": {
"url": "https://YOUR-DEPLOYMENT.convex.site/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Reload Cursor after saving.
Available tools
| Tool | What it does |
|---|---|
| list_leads | List captured leads. Filter by platform (reddit/linkedin), status, or minimum intent score. |
| get_lead | Fetch a single lead with full content, AI draft, and metadata. |
| update_lead_status | Move a lead through the pipeline (new → contacted → replied → qualified → converted / not_interested) and optionally attach a note. |
| list_monitors | List your Reddit monitors and their active state. |
| create_reddit_monitor | Create a new Reddit monitor with keywords and subreddits. Created inactive — toggle on from the dashboard. |
| generate_draft | Generate a fresh AI reply draft for a lead and save it. Counts against your daily AI draft cap. |
| search_leads | Case-insensitive substring search across lead name, headline, and content. Optionally filter by platform or status. |
| delete_lead | Permanently delete a single lead. Hard delete — cannot be undone. |
| get_usage_stats | Current plan plus live counters: leads this month, active monitors, AI drafts today, intent calls today (with limits). |
| list_api_keys | List your API keys (previews, names, scopes, timestamps). Never returns plaintext. |
| get_monitor_results | Return recent leads attributed to a specific monitor (matched by keyword or subreddit). |
Rate limits
Each API key has a token bucket with 60 tokens that refills at 1 token/second. Cheap reads cost 1 token, writes cost 2 tokens, and AI draft generation costs 10 tokens. Rate-limit errors include a retryAfter hint in seconds. This protects against runaway loops in agentic clients.
Try it from the command line
You can hit the endpoint directly to verify your key works:
curl -sS -X POST https://YOUR-DEPLOYMENT.convex.site/mcp \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Troubleshooting
- 401 Unauthorized: Check that your key starts with
lv_live_and theAuthorizationheader is set. - Tools not appearing in Claude: fully quit and relaunch Claude Desktop after editing the config.
- Daily AI cap reached:
generate_draftrespects the same daily cap as the dashboard. Free plan: 5/day. Pro: unlimited. - Need to rotate a key? Revoke the old one and generate a new one — there's no partial-edit. Revocation takes effect immediately.
Have feedback?
Email hello@leadvibe.app — we're actively adding tools (lead search, draft editing, LinkedIn monitors). Tell us what you need.
About the Model Context Protocol