roam_create_outline

Add a structured outline to an existing page or block (by title text or uid), with customizable nesting levels. To create a new page with an outline, use the

SERVERRoam Research SOURCE2b3pro/roam-research-mcp

Medium RISK CLASS

Category Write

Parameters 00 required

Recommended Rate-limitedsee the rule below

Registry record Grade D, identity unverified Pull the record →

This record as markdown: /tools/2b3pro-roam-research-mcp/roam-create-outline.md

WHAT IT DOES

What roam_create_outline does on Roam Research

AI agents use roam_create_outline to create or update resources in Roam Research, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Roam Research environment.

RISK

Why roam_create_outline is rated Medium

This tool creates new content (an outline structure) within existing pages or blocks, which is a reversible modification operation. It does not execute arbitrary code, delete data, or move money. The blast radius is medium because an AI agent could add unintended outlines to important pages, but the action is reversible via Roam's undo functionality or manual deletion.

From the tool's definition Tool name is 'roam_create_outline' and description states it will 'Add a structured outline to an existing page or block', indicating it creates or modifies data within Roam Research by adding new structured content to pages.

Attacks that exploit this kind of access

RECOMMENDED RULE

The rule that runs roam_create_outline 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_create_outline, this is the rule to start with:

roam_create_outline Rate-limited

roam_create_outline stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "roam_create_outline": {
      "limits": [
        {
          "counter": "roam_create_outline_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL → Instant setup, no code required.

The button opens the PolicyLayer dashboard: create your workspace, connect Roam Research, apply this rule, and every roam_create_outline call is checked against it from then on.

FAQ

Questions about roam_create_outline

What does the roam_create_outline tool do? +

Add a structured outline to an existing page or block (by title text or uid), with customizable nesting levels. To create a new page with an outline, use the. It is categorised as a Write tool in the Roam Research MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on roam_create_outline? +

Register the Roam Research MCP server in PolicyLayer and add a rule for roam_create_outline: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Roam Research. Nothing to install.

What risk level is roam_create_outline? +

roam_create_outline is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit roam_create_outline? +

Yes. Add a rate_limit block to the roam_create_outline rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block roam_create_outline completely? +

Set action: deny in the PolicyLayer policy for roam_create_outline. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides roam_create_outline? +

roam_create_outline is provided by the Roam Research MCP server (2b3pro/roam-research-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

KEEP EXPLORING

More on Roam Research, and thousands of servers like it.

This server

All 22 Roam Research tools →

Across the catalogue

create_task on 0rca Dojo MCP Server →create-task on Kanban MCP Server →create_package_backup on Android Forensics ADB MCP Server →create_project on Stitch MCP Server → The MCP Attack Database →

Guides

Govern customer-ops agents →Argument validation →Scoped token →