roam_import_markdown
Import nested markdown content into Roam under a specific block. Can locate the parent block by UID (preferred) or by exact string match within a specific page. If a
This record as markdown: /tools/2b3pro-roam-research-mcp/roam-import-markdown.md
What roam_import_markdown does on Roam Research
AI agents use roam_import_markdown 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.
Why roam_import_markdown is rated Medium
The tool creates new content (nested markdown blocks) within a user's Roam Research graph, making it a Write operation. It is not Destructive since imports are reversible (imported content can be deleted). Severity is high because importing malicious or incorrect markdown could corrupt significant portions of a user's knowledge base, and an AI agent given unconstrained access could bulk-import unwanted content.
From the tool's definition Tool performs import operation that creates or modifies data in Roam Research graph. Description states it can 'Import nested markdown content into Roam under a specific block', which creates new blocks/pages in the knowledge base.
Attacks that exploit this kind of access
The rule that runs roam_import_markdown 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_import_markdown, this is the rule to start with:
roam_import_markdown 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.
The button opens the PolicyLayer dashboard: create your workspace, connect Roam Research, apply this rule, and every roam_import_markdown call is checked against it from then on.
Questions about roam_import_markdown
Import nested markdown content into Roam under a specific block. Can locate the parent block by UID (preferred) or by exact string match within a specific page. If a. 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.
Register the Roam Research MCP server in PolicyLayer and add a rule for roam_import_markdown: 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.
roam_import_markdown is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the roam_import_markdown 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.
Set action: deny in the PolicyLayer policy for roam_import_markdown. 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.
roam_import_markdown 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.
More on Roam Research, and thousands of servers like it.
This server
Across the catalogue