Create a monitor
create_monitorSet up scheduled monitoring of research runs or companies and receive only new developments on each run. Read results with get_monitor_updates.
Instructions
Watch for new developments on a schedule and get only what is new each run. Three ways: (1) from_run_id: "monitor this" for a finished research run (an events dataset is re-run for new rows; a company run becomes a company monitor); (2) companies or company_list_id: new stories about those companies, optionally only those matching query (e.g. "funding, M&A, executive changes"); the default schedule is daily 09:00 UTC. Read deliveries with get_monitor_updates. Monitors are billed per run or per company (see the pricing docs); empty runs are free.
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": "create_monitor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Monitor name. | |
| query | No | Company monitors: only stories about this. Dataset monitors: the research request (default: the run's query). | |
| run_now | No | Also run it right away (within ~5 minutes) instead of waiting for the schedule. | |
| schedule | No | When it runs (default daily at 09:00 UTC; weekly for standard/max datasets). | |
| companies | No | Companies by domain. | |
| from_run_id | No | A succeeded research run to keep updated. | |
| company_list_id | No | A saved company list; the monitor follows changes to the list. | |
| include_market_activity | No | Company monitors: also stock moves and analyst ratings (default false). |