Request business research
create_business_research_requestStarts durable background business research for large people searches, emailed Excel workbooks, or unanswered fast-search requests; takes the user's original request verbatim.
Instructions
Starts slow durable background research that runs for several minutes to hours: for more than 200 people, for an explicitly requested emailed Excel workbook or background task, or for a request the fast people search (find_people, up to 200 contacts in about 15 to 60 seconds, including a company's CIO or N people at each named company) could not answer. It takes the user's original request verbatim; the backend interprets count, roles, title equivalents, personal versus employer geography, industry and size, and discovers eligible companies itself. spec is optional legacy hints that never override the request. A company's headquarters is never treated as a person's location. The same idempotency_key returns the same request. contact_provider=treg selects TREG for an explicit provider comparison; otherwise the default contact database is used. Returns the backend acknowledgment with the goal id and state (for example waiting_dependency, waiting_budget or retry_wait); work continues after the connection closes. Named people and employers are never substituted, and contacts, emails and LinkedIn are never invented. Delivery follows the account's existing authorized channel and checks. No prospect outreach.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"request": "<request>",
"idempotency_key": "<idempotency_key>"
},
"name": "create_business_research_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spec | No | ||
| request | Yes | ||
| config_id | No | ||
| research_depth | No | standard | |
| idempotency_key | Yes | ||
| contact_provider | No |