Skip to content llms.txt

Roo Code — MCP Configs

File format
JSON
Discovery path
.roo/mcp.json
Syllago install method
JSON merge
Symlink support
No
Config file
.roo/mcp.json
Transports
stdio, sse, streamable-http

Features

How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.

Fields

Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.

Config keyConversionCanonical keySummary
alwaysAllow Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → Array of tool names that skip the user confirmation prompt for that server; distinct from Cline's autoApprove field name.
disabledTools Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → Array of tool names hidden from the agent, applied alongside alwaysAllow on each server entry.
type Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → stdio, SSE, and streamable-http transports are selected via the type field on each server entry — note streamable-http is kebab-case, distinct from Cline's streamableHttp camelCase.
disabled Embedded Conversion type: Embedded No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → Boolean disabled field on a server entry turns that server off without removing its configuration.
timeout Embedded Conversion type: Embedded No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → Numeric timeout field overrides the default MCP request timeout per server.
watchPaths Embedded Conversion type: Embedded No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → Array of filesystem paths that trigger a server reload when their contents change, useful for development iteration on stdio server binaries.

Other features

Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.

FeatureConversionSummary
auto_approve Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → always_allow_list: alwaysAllow tool names bypass confirmation prompts for that server
env_var_expansion Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → env_variable_expansion: server env blocks accept environment variables so secrets can be referenced from the shell environment
tool_filtering Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → per_server_tool_filtering: alwaysAllow and disabledTools arrays on each server entry filter which MCP tools are exposed and which bypass confirmation
transport_types Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → transport_types: stdio, sse, and streamable-http are supported and selected via the type field on each server entry

Sources

Source
https://raw.githubusercontent.com/RooVetGit/Roo-Code/main/src/services/mcp/McpHub.ts
https://raw.githubusercontent.com/RooVetGit/Roo-Code/main/packages/types/src/mcp.ts
https://raw.githubusercontent.com/RooVetGit/Roo-Code/main/src/shared/globalFileNames.ts