docs
Search docs, tools, errors… ⌘K
Dashboard

Get started / Connect via MCP

Connect via MCP.

Leadsets is a remote MCP server. Add one URL to your client and your agent gets eight data tools. No install, nothing to run locally.

Pick your client

ClaudeClaude CodeCursorChatGPTOther clients
  1. Open Cursor → Settings → MCP, or edit ~/.cursor/mcp.json.
  2. Add the server below with your API key.
  3. Restart Cursor. You'll see leadsets · 8 tools with a green dot.
{
  "mcpServers": {
    "leadsets": {
      "url": "https://mcp.leadsets.ai",
      "headers": { "Authorization": "Bearer ls_live_…" }
    }
  }
}
Claude (web and desktop)

Customize → Connectors → + Add → Add custom connector → name it Leadsets and paste https://mcp.leadsets.ai → sign in. No key to paste: it uses OAuth.

Claude Code

One command:

claude mcp add --transport http leadsets \
  https://mcp.leadsets.ai

Check it works

Ask your agent: "What's my Leadsets usage?" It should call get_usage and answer with your remaining balance. If it does, you're connected.

Tools

ToolCostsReturns
search_people1 / recordpeople with match_reasons, cursor
search_companies1 / recordcompanies with match_reasons, cursor
enrich_person1 / recordperson + verified email when found
enrich_company1 / recordcompany profile
verify_email1 / email*status per email
scrape_company1 unit / pagestructured site JSON
scrape_jobs1 unit / pageopen roles
get_usagenothingevery meter + reset times

* Standalone verification counts toward enrichment. Records are only counted when data comes back; every request counts, hits and misses alike.

Previous
← Authentication
Next
Limits and costs →