Get a research_run by ID. IDs start with rr_.

List research_runs. Filters by status (default: active). Returns newest first. IDs start with rr_.

Search research_runs with text query and/or structured filters. Text query matches across all string fields (case-insensitive). Filters support: direct equality, $gt, $gte, $lt, $lte, $ne, $in, $contains, $exists. Sort with '-field' for descending. IDs start with rr_.

Delete a research_run by ID. Soft delete by default (sets status to 'deleted'). Set hard=true to permanently remove. IDs start with rr_.

Add a new field to an entity schema. Validates the change is safe, writes the updated schema to disk, and reloads it.

Force a full rebuild of the relationship index from entity files. Use this if the index seems stale or after manual file edits.

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.