roam_create_page

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-page.md

WHAT IT DOES

What roam_create_page does on Roam Research

AI agents use roam_create_page 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_page is rated Medium

This tool creates new data structures (pages) in the user's Roam Research graph, which is a reversible modification. It does not delete, execute arbitrary code, move financial assets, or perform read-only queries. The 'permanent collections' language and ability to create structured content with outlines and tables confirms this is a Write operation.

From the tool's definition Tool creates new standalone pages in Roam with content, outlines, and tables. Description states 'Create a new standalone page' and 'Making permanent collections of information', which are write operations that modify the user's knowledge graph.

Attacks that exploit this kind of access

RECOMMENDED RULE

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

roam_create_page Rate-limited

roam_create_page 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_page": {
      "limits": [
        {
          "counter": "roam_create_page_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_page call is checked against it from then on.

FAQ

Questions about roam_create_page

What does the roam_create_page tool do? +

Create a new standalone page in Roam with optional content, including structured outlines and tables, using explicit nesting levels and headings (H1-H3). This is the preferred method for creating a new page with an outline in a single step. Best for:\n- Creating foundational concept pages that other pages will link to/from\n- Establishing new topic areas that need their own namespace\n- Setting up reference materials or documentation\n- Making permanent collections of information\n- Creating pages with mixed text and table content in one call.\nEfficiency Tip: This tool batches page and content creation efficiently. For adding content to existing pages, use. 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_page? +

Register the Roam Research MCP server in PolicyLayer and add a rule for roam_create_page: 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_page? +

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

Can I rate-limit roam_create_page? +

Yes. Add a rate_limit block to the roam_create_page 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_page completely? +

Set action: deny in the PolicyLayer policy for roam_create_page. 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_page? +

roam_create_page 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 →