Skip to content
unzoi docs

mcp-remote bridge

For any client that only speaks stdio.

Kind Bridge
Transport A local stdio process that proxies to the HTTP endpoint.
Config

Setup

  1. Use the block below anywhere a client takes a stdio command.
  2. Restart the client.
  3. If the tools do not appear, run the same command in a terminal — its errors go to stderr, which the client usually hides.
{
  "mcpServers": {
    "unzoi": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.unzoi.com/mcp",
        "--header", "x-api-key:${UNZOI_KEY}"
      ],
      "env": { "UNZOI_KEY": "nai_your_key_here" }
    }
  }
}

What differs here

  • This is a workaround, not an upgrade. If your client speaks remote HTTP, use it directly — the bridge adds a process, a Node dependency and a place for the key to leak into a log.
  • It is the standard fallback for desktop clients on plans without custom connectors, and for editors whose MCP support predates Streamable HTTP.
  • Running the same command by hand is the fastest way to debug it, because a client that spawns it usually swallows stderr.

Next

Endpoint, for copying: https://api.unzoi.com/mcp