181  mcp-remote(1) - Kailash Tool Reference

181.1 mcp-remote

mcp-remote - mcp-remote — stdio/HTTP bridge for reachability and man-in-the-middle tests of remote MCP transports.

Layer ATTACK
Category a-03-agentic-mcp-tool-use
Safety class requires-target
Licence MIT
Upstream github.com/geelen/mcp-remote

181.1.1 NAME

mcp-remote - mcp-remote — stdio/HTTP bridge for reachability and man-in-the-middle tests of remote MCP transports.

181.1.2 SYNOPSIS & usage

Derived from the upstream README at generation time; verify against --help where the tool is installed.

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://remote.mcp.server/sse"
      ]
    }
  }
}
{
  // rest of config...
  "args": [
    "mcp-remote",
    "https://remote.mcp.server/sse",
    "--header",
    "Authorization:${AUTH_HEADER}" // note no spaces around ':'
  ],
  "env": {
    "AUTH_HEADER": "Bearer <auth-token>" // spaces OK in env vars
  }
},

181.1.3 DESCRIPTION (upstream)

Connect an MCP Client that only supports local (stdio) servers to a Remote MCP Server, with auth support: So far, the majority of MCP servers in the wild are installed locally, using the stdio transport. This has some benefits: both the client and the server can implicitly trust each other as the user has granted them both permission to run. Adding secrets like API keys can be done using environment variables and never leave your machine. And building on npx and uvx has allowed users to avoid explicit install steps, too. But there’s a reason most software that could be moved to the web did get moved to the web: it’s so much easier to find and fix bugs & iterate on new features when y

181.1.4 CONFIGURATION (detected)

Config-surface markers detected in the upstream README (3 matches, e.g. environment variables, environment variables). A full config reference page for this tool is queued under the config-page policy — this line is the detection record, not the page.

181.1.5 SEE ALSO

ref: v0.1.38-unstable-2026-09-20 - verified 2026-10-14