Start a research run
start_researchBuild verified news datasets or company news tables with source links; start a research run, then follow its run_id. Check time and cost first with a free dry run.
Instructions
Start the NewsCatcher research agent: it searches the news, checks each event against its sources and returns a verified table (one row per event, with source links). Runs take minutes and cost credits, so use it for datasets, not quick lookups (use search_news for those). Two kinds: (1) events: give a query describing what happened, e.g. "layoffs at US tech companies in October 2026" → rows like company, date, headcount, source_url; columns are chosen for the question. (2) companies: give companies (domains) or a company_list_id → every recent story about each company (funding, M&A, leadership, product, legal…), optionally filtered by query. keep_updated turns it into a monitor. dry_run=true checks the query and shows time and cost first, free. Returns a run_id; follow it with get_research.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Events only. fast (default): one agent, 3–10 minutes, cheapest. standard: deep research, each row checked against its sources, with a cited briefing (10–30 min). max: strongest models, highest recall and cost. | fast |
| query | No | Events: the dataset you want in plain words, with the time window, e.g. "Bank M&A deals announced in the US since October 1, 2026" or "Series A rounds by fintech startups in Europe this month". With companies: optional filter on their news, e.g. "funding, acquisitions and leadership changes" (blank = every story). | |
| dry_run | No | Check the request without starting it: what would run, how long it takes, the list-price cost, your credit balance and tips on the query. Free; nothing is started or charged. | |
| max_rows | No | Events only: rows to return at most (default 50; plans cap it, e.g. 100). Charged per 50 rows past the first 50. | |
| companies | No | Research these companies' news instead of an events query: domains like ["stripe.com","wise.com"] (up to 50 per run on self-serve plans). | |
| list_name | No | Name for the saved list. | |
| keep_updated | No | Turn the run into a monitor once it succeeds: true for the default schedule (daily 09:00 UTC; weekly for standard/max events), or a schedule object. The monitor then delivers only what is new. | |
| save_as_list | No | Also save the typed companies as a reusable list (its id comes back). | |
| wait_seconds | No | Wait up to this many seconds for the run to finish and return its results (default 0: return the run_id at once; then call get_research). | |
| lookback_days | No | Companies only: days of news to cover (default 30). | |
| company_list_id | No | A saved company list (from save_company_list) instead of typing companies. | |
| include_market_activity | No | Companies only: keep stock moves and analyst ratings (default true). |