start_research
Run a deep research task on a query. Optionally anchor on provided seed text or file URI to receive a markdown report.
Instructions
Run a research task on the given query. Supports MCP task augmentation — clients that advertise tasks.requests.tools.call may wrap the request with a task field to receive a CreateTaskResult and poll via tasks/get; clients that do not will block until the research completes and receive the full report inline. Either way, the server creates a research_run entity and updates its progress in real time so the Synapse UI can render live status. The worker typically takes ~60 seconds to 3 minutes and returns a markdown report. Pass title (3-8 word label) when you already know the topic — saves a background LLM call the server would otherwise make to derive one. Two ways to anchor research on existing material (use exactly one): seed_uri is a files:// URI the server reads itself via the host's ai.nimblebrain/host-resources extension — preferred when the host advertises the extension, since the agent doesn't have to load file bytes through its own context. seed_data is raw text passed inline by the agent — the universal fallback that works on every host. If the host doesn't support host-resources and seed_uri is provided, the tool returns a clear error telling the agent to retry with seed_data instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The research query or topic. | |
| title | No | Optional short label (3–8 words) for list rows and the detail-view heading. When omitted, the server generates one in the background via the FAST_LLM and patches the entity ~500ms later. | |
| seed_uri | No | Optional `files://<id>` URI pointing at a workspace file the research should anchor on. Resolved server-side via the `ai.nimblebrain/host-resources` extension. Prefer this when the host advertises the extension — saves the agent's context budget. | |
| seed_data | No | Optional raw text the research should anchor on. Universal fallback that works on hosts without the host-resources extension. Mutually exclusive with `seed_uri`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||