research
Decompose your query into sub-queries, search and read multiple sources in parallel, and receive a structured report with citations. Ideal for open-ended or comparative questions requiring coverage from many angles.
Instructions
Perform comprehensive research on a topic. Decomposes your query into sub-queries, searches and reads multiple sources in parallel, then synthesizes a structured report with citations. Best for open-ended or comparative questions that need coverage from many angles. For simple factual lookups, use search instead (optionally with include_answer=true for cheap synthesis). Costs 25 credits.
Returns: query, report (structured markdown with citations), sources (array of {title, url, fetched}), sub_queries (the decomposed queries), credits_used, credits_remaining, usage (token counts).
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 research question or topic | |
| topic | No | "general" (default) or "news" (prioritize recent news articles) | general |
| freshness | No | Filter by recency: "day", "week", "month", "year", or "YYYY-MM-DD:YYYY-MM-DD" | |
| max_sources | No | Maximum number of sources to use, 5-30 (default 20) |