LeadsAgent/ Documentation
Connectors
OverviewQuickstartAuthenticationAPI referenceMCPConnect ChatGPTConnect ClaudeCredits & limitsErrors & retriesConnect OpenCodeConnect Claude CodeConnect CodexConnect CursorConnect VS CodeConnect AntigravityConnect n8nAPI, MCP & plugins

MCP

Let Claude, ChatGPT, Codex or any MCP client hand jobs to LeadsAgent.

Set up with your AI assistant

Paste the prompt into Claude Code. It includes setup steps and a read-only connection check.

Server URL

Streamable HTTP
https://leadsagent.io/mcp/v1

Sign in with OAuth (every client that supports MCP authorization; no client ID needed), or send an API key in X-API-Key or Authorization: Bearer (Codex uses Bearer). Set up any of them from Connectors.

Tools

ToolWhat it does
find_leadsA structured search with yes/no steps and conditions, a research credit limit and a matching target. No agent.
search_toolsFind the tools that work on a task’s lead list: emails, verification, socials, website checks, scoring, filtering.
run_toolRun one of those tools on a task’s current lead list. No credits.
get_taskStatus, progress, credits used, any question, the agent’s reply, list counts and links.
get_task_resultsA page of saved leads (20 by default, 50 max).
share_resultsA public link to the current lead list.
start_taskGive the LeadsAgent agent a job in plain language with a max_leads budget.
reply_to_taskAnswer the agent’s question, or send a follow-up once the task finished.
get_accountCredits left and request limits.

A structured job goes to find_leads; a job that needs judgment goes to the agent with start_task. Follow either with get_task and wait_seconds, then give the user the view_url link. More work on the same list uses search_tools and run_tool, or reply_to_task.

Try it

Prompt
Use LeadsAgent to find 25 roofing companies in Denver with emails. Answer its questions sensibly and show me the ten best leads.

Clients

Step-by-step setup for each app, with its official guide:

  • Claude · official guide
  • ChatGPT · official guide
  • Gemini · official guide
  • Claude Code · official guide
  • Codex · official guide
  • Cursor · official guide
  • VS Code · official guide
  • OpenCode · official guide
  • Antigravity · official guide
  • n8n · official guide
  • Any MCP client · official guide
Agent documentation indexOpenAPI JSONMarkdown quickstart