Start a research run (billed)
researchRun multi-turn web investigations to compare options, build datasets, or enrich records; these agentic runs take minutes, incur costs, and require a configured provider key.
Instructions
Start an agentic research run: many turns of searching and reading, which takes MINUTES and bills for the run. For comparisons, datasets or enriching records; a lookup is search's. After 25s it returns a handle: poll research_status, since calling this again pays for a second run. NOTHING IS CONFIGURED FOR THIS METHOD on this machine, so every call will fail. A key in one of LINKUP_API_KEY, NIMBLE_API_KEY, PARALLEL_API_KEY, PERPLEXITY_API_KEY, YOU_API_KEY turns it on: see load_env.
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": {
"query": "<query>"
},
"name": "research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The question, or the instructions for the run. | |
| effort | No | How much work the run should do -- and how much it costs. 'max' can take an hour. | |
| provider | No | ||
| output_schema | No | JSON Schema the answer must conform to. Omit it to get prose instead. |