PlatformDocs

Auto Search

Describe your ideal customer once; new matching people are added to your leads every day.

View as Markdown
list_auto_searchesLists the Auto Searches of one website: name, status (running or paused), preferences, people per day, leads delivered today and in total, the matching pool and the last run.Read-only
build_auto_search_profileTurns a plain-English description of the ideal customer ("founders of US SaaS companies with 10-200 staff") into Auto Search preferences: field, values and weight (Must, High, Prefer or Bonus).Read-only
create_auto_searchCreates an Auto Search and starts it: every day new people matching the preferences are verified and added to the website's leads, 1 credit per lead delivered, up to perDay a day, until it is paused.Changes data · Credits
pause_auto_searchPauses one Auto Search: no more leads are delivered and no more credits are used until it is resumed.Changes data
resume_auto_searchResumes a paused Auto Search: deliveries start again today, 1 credit per lead delivered.Changes data · Credits

Connect the MCP server, then describe who you sell to. Your assistant builds the profile, shows it to you, and starts it when you say so. Each lead delivered costs 1 credit.

Use case: set one up

Find me 50 new US SaaS founders every day.

Called build_auto_search_profileShow input
{ "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9", "description": "Founders and CEOs of US SaaS companies" }

It shows you the preferences (Must, High, Prefer, Bonus), then, once you agree:

Called create_auto_searchShow input
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "name": "US SaaS founders",
  "perDay": 50,
  "prefs": [
    { "field": "job", "values": ["Founder", "CEO"], "weight": "Must" },
    { "field": "hq", "values": ["United States"], "weight": "Must" },
    { "field": "industry", "values": ["Computer Software"], "weight": "High" }
  ]
}

Use case: how is it doing?

How many leads did my Auto Searches bring in today?

It calls list_auto_searches and reads deliveredToday, deliveredTotal and pool for each one.

Use case: pause it

Pause the US SaaS founders search.

It finds the id with list_auto_searches, then calls pause_auto_search. resume_auto_search starts it again. Turn on tool approval in your assistant to confirm create_auto_search and resume_auto_search, the calls that start spending credits.

On this page