MCP Servers

Transports

The CLI accepts http and sse; both connect through the streamable HTTP client.

Template: replace the package, path, server URL, and environment-variable name before saving this in config.toml.

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "C:/work"]
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 6000
tool_timeouts = { slow_op = 120 }

[mcp_servers.remote-api]
url = "https://mcp.example.com/api"
bearer_token_env_var = "MCP_TOKEN"

startup_timeout_sec defaults to 30 seconds, tool_timeout_sec defaults to 6,000 seconds, and tool_timeouts sets per-tool overrides. On Windows, a bare npx resolves through PATHEXT, so no cmd /c wrapper is needed.

Limits and environment expansion

• MCP_TIMEOUT is milliseconds, while RIGHTNOW_MCP_STARTUP_TIMEOUT_SECS is seconds. A server's startup_timeout_sec takes precedence over both.
• Large results are truncated at 20,000 bytes by default, with the full payload stored under the session's mcp/ directory. RIGHTNOW_MAX_MCP_OUTPUT_BYTES takes precedence over MAX_MCP_OUTPUT_BYTES; [mcp] max_output_bytes sets it in config.toml.
• String values in url, command, args, env, and headers expand ${VAR} and ${VAR:-default} when configuration loads.

User and project scope

Every directory from the repository root down to the current one is read. A project server replaces a same-named user server; fields do not merge.

Command-line management

The read-only list marks project-scoped and disabled entries.

rightnow mcp list

Uppercase words are placeholders. The transport defaults to stdio. Add writes user scope unless --scope project is supplied.

• Both -e and -H are repeatable. Environment and header values are stored verbatim, so reference secrets as ${VAR} in project configuration.
• Names given to add may contain only letters, digits, hyphens, and underscores. disable writes the user config.toml; enable does too, and clears enabled = false in the nearest project file that defines the server. remove needs --scope when both scopes define the name.

Authentication

• bearer_token_env_var names an environment variable whose value becomes the Bearer token.
• OAuth configuration can provide a client ID, a client-secret environment-variable name, and requested scopes. Use oauth_client_id, oauth_client_secret_env_var, and oauth_scopes.
• Authenticate a supported OAuth server from /mcps. Browser OAuth tokens are stored in mcp_credentials.json under the effective product home; on Unix the file uses owner-only permissions.

Runtime controls and discovery

• /mcps opens the MCP Servers tab: Space toggles, Enter lists tools, r reloads, i authenticates, a adds, and x removes a local server.
• Tool names use server__tool, such as github__create_issue.
• search_tool finds tools across enabled servers; use_tool calls one by its full name.

Servers from other tools

Also read in place, below config.toml:

• On a name conflict, config.toml wins, then Claude Code, Cursor, and .mcp.json. rightnow inspect shows each server's origin.
• /import-claude copies Claude Code servers into config.toml; afterwards ~/.claude.json and .mcp.json are no longer read.
• Codex servers are not read in place. The Windows helper, run from the agent repository root, imports Claude Code or Codex definitions with -WithMcp; see the migration guide.