conecto. Get started
Prospects

List prospect searches

prospects_list · Reads only · Markdown

The business's prospect searches, newest first, with their status and how many each found.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

What lead searches have we run this month?

Your agent callsprospects_listFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "limit": 10
}
What comes back
{
  "searches": [
    {
      "search_id": "85d3d5b9-0f8b-482b-8ad0-4ec057beebb6",
      "status": "completed",
      "summary": "40 independent restaurants and hotel kitchens in Hamburg, with a working email for the owner or the head chef.",
      "asked": 40,
      "found": 2,
      "started_at": "2026-10-14T08:00:00+00:00",
      "ended_at": "2026-10-14T08:00:00Z"
    }
  ]
}

Use it when

To find an earlier search, or the id of one that is running.

What it does

The account's prospect searches, newest first: status, what each asked for and how many it found.

What comes back

searches: each with search_id, status, summary, asked, found, started_at and ended_at. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
limitinteger1 to 50. Default: 10.

The call

Over MCP, call prospects_list on https://api.conecto.chat/mcp/prospects. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/prospects_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":10}'

More Prospects tools

All 7 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md