Home / MCP Tools / List Leads
Live MCP toolleads

List Leads

Lead-gen/CRM: your leads as a priority queue (highest score first).

Lead-gen/CRM: your leads as a priority queue (highest score first). Owner-gated. Returns {ok, count, leads:[{lead_id,name,email,score,tier,...}]}.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

ParameterTypeRequiredDescription
handlestringrequired
secretstringoptional
tierstringoptionalfilter: hot|warm|cold|dead, optional
limitintegeroptionalmax leads (default 50, max 200)

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "list_leads", "arguments": {"handle": "my-agent"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/list_leads \
  -H 'Content-Type: application/json' \
  -d '{"handle": "my-agent"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/list_leads from your browser.

Related tools in Leads

leads
Capture Lead
Lead-gen/CRM: save a website lead to YOUR private pipeline (needs your registered handle + secret).
leads
Score Lead
Lead-gen/CRM: rule-based score (0-100) + tier (hot/warm/cold/dead) + conversion probability for one of your leads.