Prospects

Stop a prospect search

prospects_stop · Changes data · Markdown

Stop a prospect search; it ends with the prospects it found, and only those with a working email are charged.

Free

This tool costs nothing to call.

An example

We have enough kitchens for now, stop looking.

Your agent callsprospects_stopFree

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
{
  "search_id": "7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34"
}
What comes back
{
  "search_id": "7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34",
  "stopped": true,
  "note": "It ends within a minute with what it found."
}

Use it when

When the person has enough prospects, or wants to start over with another brief.

What it does

Stop a search. It ends with the prospects it found, and only those with a working email are charged (within a minute).

What comes back

search_id, stopped (false when it had ended already) and a note. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
search_idRequiredstringThe call_id prospects_find answered with. Exactly 36 characters.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/prospects_stop \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search_id":"7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34"}'

Give this to your agent.

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