roam_search_by_status

What roam_search_by_status does on Roam Research

AI agents call roam_search_by_status to retrieve information from Roam Research without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why roam_search_by_status is rated Low

This tool performs a search query to find and retrieve blocks based on their status attribute. It has no side effects—it only fetches and returns matching data. The verb 'search' and the absence of any modification, deletion, or execution language confirm this is a Read operation with low severity since misuse would only expose existing data without enabling destructive or financial harm.

From the tool's definition Tool name 'roam_search_by_status' and description 'Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page' indicates a read-only query operation that retrieves data without modifying it.

The rule that runs roam_search_by_status safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Roam Research, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For roam_search_by_status, this is the rule to start with:

{
  "version": "1",
  "default": "deny",
  "tools": {
    "roam_search_by_status": {}
  }
}

Questions about roam_search_by_status