MCP & AI Agent Integration

Roamresearch
automation.

11 AI agent actions for Roamresearch — callable from any MCP-compatible runtime, Claude, Cursor, or Cerebral OS workflow. Use Roamresearch to automate business processes and connect tools in your stack. Full governance, audit trail, and dry-run safety on every execution.

No credit card required
Live in production environments
<200ms median execution
Dry-run before production
Execution trace
live
11
actions
100%
governed
<200ms
latency
11
AI agent actions
6
Read operations
5
Write operations
1
High-risk actions (approval gated)
Business Tools Roamresearch is a Business Tools integration — use it to automate business operations and workflow automation from any AI agent or MCP-compatible runtime.
Actions

What you can do
with Roamresearch.

Every action below is available as an MCP tool and a verb in Cerebral OS — callable from any AI agent, Claude, Cursor, Windsurf, or your own runtime via the BYOA API. All executions are governed, audited, and dry-run safe.

Get Block
roamresearch:get_block
Fetch a single block by UID with its content and metadata.
Read Low risk
Get Daily Note
roamresearch:get_daily_note
Get the daily note page for a specific date with its blocks.
Read Low risk
Get Page
roamresearch:get_page
Fetch a page by UID or title with its blocks and metadata.
Read Low risk
List Blocks
roamresearch:list_blocks
List blocks with optional filtering by page or search string.
Read Low risk
List Pages
roamresearch:list_pages
List all pages in the graph with optional title filtering.
Read Low risk
Search Blocks
roamresearch:search_blocks
Search for blocks containing the specified text across the entire graph.
Read Low risk
Create Block
roamresearch:create_block
Create a new block with the specified content and location.
Write Medium risk
Create Page
roamresearch:create_page
Create a new page with the specified title and optional initial content.
Write Medium risk
Delete Block
roamresearch:delete_block
Delete a block and all its children permanently.
Write High risk
Move Block
roamresearch:move_block
Move a block to a new parent and position.
Write Medium risk
Update Block
roamresearch:update_block
Update the content of an existing block.
Write Medium risk
MCP & Runtime API

Call Roamresearch
from any AI agent.

Any AI agent — Claude, Cursor, LangChain, AutoGen, or your own — can call Roamresearch actions through the Cerebral OS Runtime API. Governance, credentials, and audit trail fire automatically.

roamresearch:get_block READ
# Call via Runtime API
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "roamresearch:get_block",
    "args": {},
    "execution_id": "agent-001"
  }'
roamresearch:create_block WRITE
# Dry-run first — no production risk
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "roamresearch:create_block",
    "args": {},
    "execution_id": "agent-001",
    "metadata": {"dryRun": true}
  }'
Get your Runtime API key at app.cerebralos.com/signup — 1,000 free executions, no credit card required.
AI agent examples

What your AI agent
can do with Roamresearch.

Real patterns your AI agent can execute via MCP or the Runtime API. Every action governed, dry-run safe, and fully audited.

Trigger
AI agent needs Roamresearch data
Call roamresearch:get_block via MCP or Runtime API
AI processes result and takes next action
Full execution logged to audit trail automatically
Trigger
Workflow needs to write to Roamresearch
Dry-run validates roamresearch:create_block before execution
Approval gate fires if risk level is high
Action executes with full governance — logged, audited, reversible
Trigger
Event in Roamresearch
Process with AI agent
Take governed action
Log to audit trail
How it works

Every Roamresearch action
governed end-to-end.

Cerebral OS isn't a connector. It's the execution layer that sits in front of Roamresearch — adding governance, dry-run safety, and a full audit trail to every operation.

Governance first
Every verb carries a risk classification. High-risk writes require explicit approval gates before they execute in production.
Dry-run safe
Simulate any Roamresearch action before it touches production. See exactly what would happen before a single real call is made.
Immutable audit trail
Every Roamresearch action is logged — what ran, what changed, who approved it, when it happened. Full history on every verb, forever.
Connect with

Roamresearch works best
alongside these.

Build multi-step workflows that connect Roamresearch to the rest of your stack. All governed. All audited.

Roamresearch integration

Start free.
No credit card required.

Start free with 1,000 runs — no credit card required. Connect Roamresearch in minutes, dry-run every action before it touches production, full audit trail on everything.

Start free — 1,000 runs Browse all integrations →