As a server — rbs mcp serve exposes the agent’s tool surface (graph queries, build/test, search, skills) to any MCP client: Claude Desktop, Claude Code, ChatGPT, or your own tooling.
As a client — MCP servers declared in your workspace give the rbs agent extra tools (a browser, a database, an internal API) for its sessions and for ai_task targets.
Start with Use ReasonOS with your AI assistant for goal-oriented
workflows, connection boundaries and instructions you can give your assistant.
Serving rbs as an MCP server
# stdio mode — for Claude Desktop, Claude Code, and similar clientsrbs mcp serve# HTTP mode — a streamable HTTP serverrbs mcp serve --http :3001
In stdio mode the server speaks MCP on stdin/stdout. In HTTP mode, point your client at http://localhost:3001/mcp.A Claude Desktop configuration looks like:
Run it from (or configure the client to start it in) your workspace directory — the server loads the workspace so graph and authoring tools answer from your real target graph.
The curated tool surface
By default the server exposes a curated subset of the agent’s tools: file reading, search, the graph and knowledge-graph queries, build/test, dependency inspection, and skills. Several tool categories are excluded on purpose:
Interactive tools that block waiting on the rbs UI (they would hang your client)
Agent-loop internals (todo management, plan mode) that only make sense inside the rbs agent’s own loop
Agent-spawning tools (delegation, background agents) that would issue LLM calls from inside the server
Write tools that mutate the workspace or run commands — excluded unless you opt in
Adjust the surface with flags shared by serve and list:
# Include mutating tools (write_file, str_replace, delete_file,# run_command, rbs_run, task/lesson writers) in the curated surfacerbs mcp serve --allow-write# Expose every runtime toolrbs mcp serve --tools full# Drop specific tools by name (applies in both modes)rbs mcp serve --exclude-tools rbs_run,delete_file
--allow-write and --tools full let a connected client edit files and execute commands in your workspace. Only enable them for clients you trust, and prefer --exclude-tools to trim anything you don’t want reachable.
Previewing the surface
rbs mcp list prints exactly what a connected client would see, honoring the same flags — including which tools are excluded and why:
rbs mcp listrbs mcp list --tools fullrbs mcp list --allow-write --exclude-tools rbs_run
Skills as resources and prompts
Beyond tools, the server publishes the agent’s skill corpus:
every skill is an MCP resource under rbs://skills/<name> (for example rbs://skills/bootstrap-workspace, rbs://skills/using-go-rules)
two composed prompts let a client bootstrap rbs context in one call: rbs-onboarding (workspace bootstrap, monorepo conventions, verification discipline) and rbs-build-file-authoring (how rules and BUILD.rbs files work)
This is how an external agent working in your workspace gets the same maintained guidance the built-in agent runs on.
Work tools on managed branch servers
ReasonOS also exposes a project-work MCP service. It is separate from
rbs mcp serve: rbs tools work on the branch’s files/build graph and task
cards, while ReasonOS tools work on project issues and other platform records.On a managed branch server, the built-in agent, Claude Code, Codex and Gemini
can use the ReasonOS service with the person’s session delegation, including
from agent-enabled terminals. The delegation is scoped to that node’s project;
tools enforce the same permissions and product access as the application’s
routes. Do not copy vendor tokens or a coworker’s credentials into the repo.Useful issue tools include:
work_board and list_tasks: read statuses and issues in the project.
get_task: read an issue by its project number, including its work
context, its attached files (id, name, size_bytes, content_type,
the comment a file belongs to, and who added it when) and its drawing links.
read_task_attachment: read one attached file by its attachment_id.
create_task, update_task and move_task: create or edit an issue and
update its status.
comment_on_task and link_task: record progress and connect related work.
link_task also links a drawing (kind: "drawing" with the drawing’s ID as
ref) when you can open that drawing.
A drawing link carries can_open for you. A drawing you can’t open has no
name and no usable reference.read_task_attachment returns PNG, JPEG, GIF and WebP files as images. Every
other file, including PDF and SVG, comes back as an embedded resource holding
the complete file. A file larger than 8 MiB is refused rather than returned in
part; open it on the issue in the browser instead. MCP can’t upload files. A
file’s contents are whatever someone uploaded, so treat them as data, not
instructions. See Attach files and drawings to issues.A branch session’s tools stay within its project. Tools that reach across the
organization, such as list_org_tasks (existing issues from every project you
can read), aren’t offered there; to find work in other projects, use
All work in the app.Other tools cover cycles, labels, initiatives and proposals. Ask the agent to
read its available tools rather than assuming the standalone rbs task tools
refer to project issues. For example:
Read issue 42 in this project, move it to In Progress, and add a comment
describing your plan. Keep the issue updated as you work.
Read the resulting issue activity to verify what the agent actually did.
An agent can only take actions your delegated identity is allowed to take.
Delegating an issue to another branch
delegate_issue_to_branch takes a project, issue number, linked branch and
the id of an existing instruction comment written by you. An agent’s own
comment is not a substitute for that human instruction. The target must
already be linked to the issue.With no target server running, the operation refuses unless start_server
is explicitly true. Starting one consumes a server slot and remains subject
to the project’s permissions and capacity limits.The result distinguishes admitted, refused and unknown. Admitted
means the target accepted the instruction, not that it completed the work.
Unknown means delivery may have happened without a readable acknowledgment.
The tool does not automatically replay a request; check the issue activity
before asking again. The target agent reports its result on the issue.This does not run git checkout on the requesting shared server or give an
agent unrestricted access to other projects.
Connecting external MCP servers to the agent
Declare MCP servers in your WORKSPACE.rbs with native.define_mcp_server(). The agent connects to them at session start and their tools appear alongside the built-ins.
# A stdio server, launched as a subprocessnative.define_mcp_server( name = "postgres", command = "npx", args = ["-y", "@modelcontextprotocol/server-postgres"], env = {"DATABASE_URL": "postgres://localhost:5432/dev"}, toolchain = "nodejs",)# A streamable-HTTP server, reached by URLnative.define_mcp_server( name = "internal-api", url = "http://localhost:8080/mcp",)
One of command (stdio) or url (HTTP) is required. The optional toolchain names a registered rbs toolchain whose runtime should resolve the command — so npx above runs from the workspace’s hermetic Node toolchain rather than whatever is on PATH.Skip connecting for a session with rbs agent --no-mcp.
The Chrome DevTools server
For browser automation, rbs bundles a helper that registers a Chrome DevTools MCP server. Name it in an ai_task target’s mcp attribute to give the agent a real browser:
load("@rbs//agent/mcp/chrome/mcp.rbs", "chrome_mcp_server")chrome_mcp_server( name = "chrome", headless = True, # Set install_chrome = True to download Chrome for Testing via the # toolchain system — useful in CI where no browser is installed.)
MCP in ai_task targets
Headless agent tasks name the servers they need with the mcp attribute; only those servers are connected for the run:
native.ai_task( name = "qa_checkout", todos = ["open the store", "add an item to the cart", "verify the total"], mcp = ["chrome"], run_targets = [":dev"],)
MCP and the external engines
When a session runs on an external engine, rbs
configures the agent with the workspace’s declared MCP servers and rbs’s own
tools. Managed branch sessions also receive the scoped ReasonOS Work service
described above. These services have different permissions and purposes;
enabling a standalone rbs MCP server alone does not connect it to ReasonOS
project issues.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ReasonOS Documentation","colors":{"primary":"#22c55e","light":"#5dc984","dark":"#1c8b45"},"logo":{"light":"https://mintcdn.com/reasonos/lusPOrxgbxqrzvHj/logo/light.svg?fit=max\u0026auto=format\u0026n=lusPOrxgbxqrzvHj\u0026q=85\u0026s=bbba5825cb46eca5046d24cb40bc52ac","dark":"https://mintcdn.com/reasonos/lusPOrxgbxqrzvHj/logo/dark.svg?fit=max\u0026auto=format\u0026n=lusPOrxgbxqrzvHj\u0026q=85\u0026s=4bf966b910c3ebe602eb7d87a678d9b2"},"favicon":"https://mintcdn.com/reasonos/lusPOrxgbxqrzvHj/favicon.svg?fit=max\u0026auto=format\u0026n=lusPOrxgbxqrzvHj\u0026q=85\u0026s=1aa9e554f11c6a22169ccb69ecf49bd5","navbar":{"links":[{"href":"mailto:support@reasonos.com","label":"Support"}],"primary":{"type":"button","label":"Get Started","href":"https://reasonos.com/get-started"}},"footer":{"socials":{"x":"https://x.com/reasonos","website":"https://blog.reasonos.com"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://blog.reasonos.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reasonos","hasAudioNarration":false,"actualSubdomain":"reasonos","customDomains":["docs.reasonos.com"],"gitSource":{"type":"github","owner":"reasonos","repo":"reasonos-mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afd08d18745fb0d64fcde6d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Guides","count":41},{"language":"default","tag":"Editor","count":22},{"language":"default","tag":"Platform","count":17},{"language":"default","tag":"Team Workflow","count":12},{"language":"default","tag":"Reference","count":8},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"Build","count":7},{"language":"default","tag":"Languages","count":6},{"language":"default","tag":"The ReasonOS Editor","count":5},{"language":"default","tag":"CLI","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"agents/mcp","slug":"/agents/mcp","pageMetadata":{"title":"MCP Integration","description":"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.","icon":"plug","href":"/agents/mcp"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`rbs integrates with the `,_jsx(_components.a,{href:`https://modelcontextprotocol.io`,children:`Model Context Protocol`}),` in both directions:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`As a server`}),` — `,_jsx(_components.code,{children:`rbs mcp serve`}),` exposes the agent’s tool surface (graph queries, build/test, search, skills) to any MCP client: Claude Desktop, Claude Code, ChatGPT, or your own tooling.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`As a client`}),` — MCP servers declared in your workspace give the rbs agent extra tools (a browser, a database, an internal API) for its sessions and for `,_jsx(_components.code,{children:`ai_task`}),` targets.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Start with `,_jsx(_components.a,{href:`/ai`,children:`Use ReasonOS with your AI assistant`}),` for goal-oriented\nworkflows, connection boundaries and instructions you can give your assistant.`]}),`\n`,_jsx(Heading,{level:`2`,id:`serving-rbs-as-an-mcp-server`,children:`Serving rbs as an MCP server`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# stdio mode — for Claude Desktop, Claude Code, and similar clients`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` serve`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# HTTP mode — a streamable HTTP server`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` serve`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --http`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` :3001`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`In stdio mode the server speaks MCP on stdin/stdout. In HTTP mode, point your client at `,_jsx(_components.code,{children:`http://localhost:3001/mcp`}),`.`]}),`\n`,_jsx(_components.p,{children:`A Claude Desktop configuration looks like:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rbs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"command\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"rbs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"args\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"serve\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Run it from (or configure the client to start it in) your workspace directory — the server loads the workspace so graph and authoring tools answer from your real target graph.`}),`\n`,_jsx(Heading,{level:`3`,id:`the-curated-tool-surface`,children:`The curated tool surface`}),`\n`,_jsxs(_components.p,{children:[`By default the server exposes a `,_jsx(_components.strong,{children:`curated`}),` subset of the agent’s tools: file reading, search, the graph and knowledge-graph queries, build/test, dependency inspection, and skills. Several tool categories are excluded on purpose:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Interactive tools`}),` that block waiting on the rbs UI (they would hang your client)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Agent-loop internals`}),` (todo management, plan mode) that only make sense inside the rbs agent’s own loop`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Agent-spawning tools`}),` (delegation, background agents) that would issue LLM calls from inside the server`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Write tools`}),` that mutate the workspace or run commands — excluded unless you opt in`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Adjust the surface with flags shared by `,_jsx(_components.code,{children:`serve`}),` and `,_jsx(_components.code,{children:`list`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Include mutating tools (write_file, str_replace, delete_file,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# run_command, rbs_run, task/lesson writers) in the curated surface`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` serve`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --allow-write`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Expose every runtime tool`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` serve`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --tools`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` full`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Drop specific tools by name (applies in both modes)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` serve`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --exclude-tools`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rbs_run,delete_file`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--allow-write`}),` and `,_jsx(_components.code,{children:`--tools full`}),` let a connected client edit files and execute commands in your workspace. Only enable them for clients you trust, and prefer `,_jsx(_components.code,{children:`--exclude-tools`}),` to trim anything you don’t want reachable.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`previewing-the-surface`,children:`Previewing the surface`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`rbs mcp list`}),` prints exactly what a connected client would see, honoring the same flags — including which tools are excluded and why:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --tools`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` full`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rbs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --allow-write`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --exclude-tools`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rbs_run`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`skills-as-resources-and-prompts`,children:`Skills as resources and prompts`}),`\n`,_jsxs(_components.p,{children:[`Beyond tools, the server publishes the agent’s `,_jsx(_components.a,{href:`/agents/skills`,children:`skill corpus`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`every skill is an MCP `,_jsx(_components.strong,{children:`resource`}),` under `,_jsx(_components.code,{children:`rbs://skills/\u003cname>`}),` (for example `,_jsx(_components.code,{children:`rbs://skills/bootstrap-workspace`}),`, `,_jsx(_components.code,{children:`rbs://skills/using-go-rules`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`two composed `,_jsx(_components.strong,{children:`prompts`}),` let a client bootstrap rbs context in one call: `,_jsx(_components.code,{children:`rbs-onboarding`}),` (workspace bootstrap, monorepo conventions, verification discipline) and `,_jsx(_components.code,{children:`rbs-build-file-authoring`}),` (how rules and `,_jsx(_components.code,{children:`BUILD.rbs`}),` files work)`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This is how an external agent working in your workspace gets the same maintained guidance the built-in agent runs on.`}),`\n`,_jsx(Heading,{level:`2`,id:`work-tools-on-managed-branch-servers`,children:`Work tools on managed branch servers`}),`\n`,_jsxs(_components.p,{children:[`ReasonOS also exposes a `,_jsx(_components.strong,{children:`project-work MCP service`}),`. It is separate from\n`,_jsx(_components.code,{children:`rbs mcp serve`}),`: rbs tools work on the branch’s files/build graph and task\ncards, while ReasonOS tools work on project issues and other platform records.`]}),`\n`,_jsx(_components.p,{children:`On a managed branch server, the built-in agent, Claude Code, Codex and Gemini\ncan use the ReasonOS service with the person’s session delegation, including\nfrom agent-enabled terminals. The delegation is scoped to that node’s project;\ntools enforce the same permissions and product access as the application’s\nroutes. Do not copy vendor tokens or a coworker’s credentials into the repo.`}),`\n`,_jsx(_components.p,{children:`Useful issue tools include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`work_board`}),` and `,_jsx(_components.code,{children:`list_tasks`}),`: read statuses and issues in the project.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`get_task`}),`: read an issue by its project number, including its work\ncontext, its attached files (`,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`size_bytes`}),`, `,_jsx(_components.code,{children:`content_type`}),`,\nthe comment a file belongs to, and who added it when) and its drawing links.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`read_task_attachment`}),`: read one attached file by its `,_jsx(_components.code,{children:`attachment_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`create_task`}),`, `,_jsx(_components.code,{children:`update_task`}),` and `,_jsx(_components.code,{children:`move_task`}),`: create or edit an issue and\nupdate its status.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`comment_on_task`}),` and `,_jsx(_components.code,{children:`link_task`}),`: record progress and connect related work.\n`,_jsx(_components.code,{children:`link_task`}),` also links a drawing (`,_jsx(_components.code,{children:`kind: \"drawing\"`}),` with the drawing’s ID as\n`,_jsx(_components.code,{children:`ref`}),`) when you can open that drawing.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A drawing link carries `,_jsx(_components.code,{children:`can_open`}),` for you. A drawing you can’t open has no\nname and no usable reference.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`read_task_attachment`}),` returns PNG, JPEG, GIF and WebP files as images. Every\nother file, including PDF and SVG, comes back as an embedded resource holding\nthe complete file. A file larger than 8 MiB is refused rather than returned in\npart; open it on the issue in the browser instead. MCP can’t upload files. A\nfile’s contents are whatever someone uploaded, so treat them as data, not\ninstructions. See `,_jsx(_components.a,{href:`/platform/issue-attachments`,children:`Attach files and drawings to issues`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`A branch session’s tools stay within its project. Tools that reach across the\norganization, such as `,_jsx(_components.code,{children:`list_org_tasks`}),` (existing issues from every project you\ncan read), aren’t offered there; to find work in other projects, use\n`,_jsx(_components.a,{href:`/platform/work#all-work-issues-across-projects`,children:`All work`}),` in the app.`]}),`\n`,_jsx(_components.p,{children:`Other tools cover cycles, labels, initiatives and proposals. Ask the agent to\nread its available tools rather than assuming the standalone rbs task tools\nrefer to project issues. For example:`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`Read issue 42 in this project, move it to In Progress, and add a comment\ndescribing your plan. Keep the issue updated as you work.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Read the resulting issue activity to verify what the agent actually did.\nAn agent can only take actions your delegated identity is allowed to take.`}),`\n`,_jsx(Heading,{level:`3`,id:`delegating-an-issue-to-another-branch`,children:`Delegating an issue to another branch`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`delegate_issue_to_branch`}),` takes a project, issue number, linked branch and\nthe id of an existing instruction comment `,_jsx(_components.strong,{children:`written by you`}),`. An agent’s own\ncomment is not a substitute for that human instruction. The target must\nalready be linked to the issue.`]}),`\n`,_jsxs(_components.p,{children:[`With no target server running, the operation refuses unless `,_jsx(_components.code,{children:`start_server`}),`\nis explicitly true. Starting one consumes a server slot and remains subject\nto the project’s permissions and capacity limits.`]}),`\n`,_jsxs(_components.p,{children:[`The result distinguishes `,_jsx(_components.strong,{children:`admitted`}),`, `,_jsx(_components.strong,{children:`refused`}),` and `,_jsx(_components.strong,{children:`unknown`}),`. Admitted\nmeans the target accepted the instruction, not that it completed the work.\nUnknown means delivery may have happened without a readable acknowledgment.\nThe tool does not automatically replay a request; check the issue activity\nbefore asking again. The target agent reports its result on the issue.`]}),`\n`,_jsxs(_components.p,{children:[`This does not run `,_jsx(_components.code,{children:`git checkout`}),` on the requesting shared server or give an\nagent unrestricted access to other projects.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connecting-external-mcp-servers-to-the-agent`,children:`Connecting external MCP servers to the agent`}),`\n`,_jsxs(_components.p,{children:[`Declare MCP servers in your `,_jsx(_components.code,{children:`WORKSPACE.rbs`}),` with `,_jsx(_components.code,{children:`native.define_mcp_server()`}),`. The agent connects to them at session start and their tools appear alongside the built-ins.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# A stdio server, launched as a subprocess`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`native.define_mcp_server(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"postgres\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` command`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"npx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` args`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"-y\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"@modelcontextprotocol/server-postgres\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` env`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DATABASE_URL\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"postgres://localhost:5432/dev\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` toolchain`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"nodejs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# A streamable-HTTP server, reached by URL`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`native.define_mcp_server(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"internal-api\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"http://localhost:8080/mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`command`}),` (stdio) or `,_jsx(_components.code,{children:`url`}),` (HTTP) is required. The optional `,_jsx(_components.code,{children:`toolchain`}),` names a registered rbs toolchain whose runtime should resolve the command — so `,_jsx(_components.code,{children:`npx`}),` above runs from the workspace’s hermetic Node toolchain rather than whatever is on `,_jsx(_components.code,{children:`PATH`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Skip connecting for a session with `,_jsx(_components.code,{children:`rbs agent --no-mcp`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-chrome-devtools-server`,children:`The Chrome DevTools server`}),`\n`,_jsxs(_components.p,{children:[`For browser automation, rbs bundles a helper that registers a Chrome DevTools MCP server. Name it in an `,_jsx(_components.code,{children:`ai_task`}),` target’s `,_jsx(_components.code,{children:`mcp`}),` attribute to give the agent a real browser:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`load(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"@rbs//agent/mcp/chrome/mcp.rbs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chrome_mcp_server\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`chrome_mcp_server(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"chrome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headless`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # Set install_chrome = True to download Chrome for Testing via the`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # toolchain system — useful in CI where no browser is installed.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`3`,id:`mcp-in-ai_task-targets`,children:[`MCP in `,_jsx(_components.code,{children:`ai_task`}),` targets`]}),`\n`,_jsxs(_components.p,{children:[`Headless `,_jsx(_components.a,{href:`/agents/using-the-agent#headless-agent-tasks-in-the-build-graph`,children:`agent tasks`}),` name the servers they need with the `,_jsx(_components.code,{children:`mcp`}),` attribute; only those servers are connected for the run:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`native.ai_task(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"qa_checkout\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` todos`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"open the store\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"add an item to the cart\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"verify the total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` mcp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chrome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` run_targets`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\":dev\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`mcp-and-the-external-engines`,children:`MCP and the external engines`}),`\n`,_jsxs(_components.p,{children:[`When a session runs on an `,_jsx(_components.a,{href:`/agents/overview#engines`,children:`external engine`}),`, rbs\nconfigures the agent with the workspace’s declared MCP servers and rbs’s own\ntools. Managed branch sessions also receive the scoped ReasonOS Work service\ndescribed above. These services have different permissions and purposes;\nenabling a standalone rbs MCP server alone does not connect it to ReasonOS\nproject issues.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"MCP Integration","description":"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.","icon":"plug","href":"/agents/mcp"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Serving rbs as an MCP server","slug":"serving-rbs-as-an-mcp-server","depth":2,"children":[{"title":"The curated tool surface","slug":"the-curated-tool-surface","depth":3,"children":[]},{"title":"Previewing the surface","slug":"previewing-the-surface","depth":3,"children":[]},{"title":"Skills as resources and prompts","slug":"skills-as-resources-and-prompts","depth":3,"children":[]}]},{"title":"Work tools on managed branch servers","slug":"work-tools-on-managed-branch-servers","depth":2,"children":[{"title":"Delegating an issue to another branch","slug":"delegating-an-issue-to-another-branch","depth":3,"children":[]}]},{"title":"Connecting external MCP servers to the agent","slug":"connecting-external-mcp-servers-to-the-agent","depth":2,"children":[{"title":"The Chrome DevTools server","slug":"the-chrome-devtools-server","depth":3,"children":[]},{"title":"MCP in ai_task targets","slug":"mcp-in-ai_task-targets","depth":3,"children":[]}]},{"title":"MCP and the external engines","slug":"mcp-and-the-external-engines","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"reasonos","siteName":"ReasonOS Documentation","title":"MCP Integration - ReasonOS Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-24T11:59:19.101Z","originalFileLocation":"agents/mcp.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ReasonOS Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"MCP Integration - ReasonOS Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ReasonOS Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.reasonos.com/agents/mcp\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://reasonos.mintlify.site/_mintlify/api/og/v2?division=Coding+Agent\u0026amp;title=MCP+Integration\u0026amp;description=rbs+speaks+the+Model+Context+Protocol+in+both+directions%3A+serve+rbs+tools+to+any+MCP+client%2C+and+connect+external+MCP+servers+to+the+rbs+agent.\u0026amp;theme=68579bdd2d5db2896e6d3913\u0026amp;signature=d2c06ebf9a83f851b2e30f647e9c754437e66e47cf4005476d66c32ca82266e7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"MCP Integration - ReasonOS Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://reasonos.mintlify.site/_mintlify/api/og/v2?division=Coding+Agent\u0026amp;title=MCP+Integration\u0026amp;description=rbs+speaks+the+Model+Context+Protocol+in+both+directions%3A+serve+rbs+tools+to+any+MCP+client%2C+and+connect+external+MCP+servers+to+the+rbs+agent.\u0026amp;theme=68579bdd2d5db2896e6d3913\u0026amp;signature=d2c06ebf9a83f851b2e30f647e9c754437e66e47cf4005476d66c32ca82266e7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/reasonos/XjDjRfU2dFUEL9uH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ReasonOS Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#22c55e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.reasonos.com/agents/mcp\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agents/mcp.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.reasonos.com/#organization\",\"name\":\"ReasonOS Documentation\",\"url\":\"https://docs.reasonos.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reasonos/lusPOrxgbxqrzvHj/logo/light.svg?fit=max\u0026auto=format\u0026n=lusPOrxgbxqrzvHj\u0026q=85\u0026s=bbba5825cb46eca5046d24cb40bc52ac\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.reasonos.com#website\",\"name\":\"ReasonOS Documentation\",\"url\":\"https://docs.reasonos.com\",\"publisher\":{\"@id\":\"https://docs.reasonos.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.reasonos.com/agents/mcp#webpage\",\"url\":\"https://docs.reasonos.com/agents/mcp\",\"name\":\"MCP Integration\",\"description\":\"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.\",\"dateModified\":\"2026-10-24T11:59:19.101Z\",\"isPartOf\":{\"@id\":\"https://docs.reasonos.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.reasonos.com/agents/mcp#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.reasonos.com/agents/mcp#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Coding Agent\",\"item\":\"https://docs.reasonos.com/agents/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP Integration\",\"item\":\"https://docs.reasonos.com/agents/mcp\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.reasonos.com/agents/mcp#article\",\"headline\":\"MCP Integration\",\"name\":\"MCP Integration\",\"description\":\"rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.\",\"url\":\"https://docs.reasonos.com/agents/mcp\",\"mainEntityOfPage\":{\"@id\":\"https://docs.reasonos.com/agents/mcp#webpage\"},\"dateModified\":\"2026-10-24T11:59:19.101Z\",\"publisher\":{\"@id\":\"https://docs.reasonos.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.reasonos.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ReasonOS Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ReasonOS Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/agents/mcp.md","siteName":"ReasonOS Documentation","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://blog.reasonos.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Editor","pages":[{"title":"Editor","href":"/editor/overview"}]},{"tab":"Agents","groups":[{"group":"Coding Agent","pages":[{"title":"Coding Agent Overview","icon":"bot","href":"/agents/overview"},{"title":"Using the Agent","icon":"terminal","href":"/agents/using-the-agent"},{"title":"Agent Skills","description":"Skills are loadable units of expertise — how to work in your repository. The agent ships a built-in corpus and learns new skills from your workspace.","icon":"graduation-cap","href":"/agents/skills"},{"title":"MCP Integration","icon":"plug","href":"/agents/mcp"}]}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/cli/overview"}]},{"tab":"Legal","hidden":true,"pages":[{"title":"Legal","href":"/legal/tou"}]}]},"basePath":"","title":"MCP Integration - ReasonOS Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}