---
title: "mcp-remote 0.1.38 — MCP compatibility"
description: "The bridge that retrofits OAuth onto a client that lacks it, by presenting a remote server over stdio. Its `--transport` flag chooses which HTTP transport to try first, and it keeps a separate token cache per combination of URL, resource, and headers."
canonicalUrl: "https://zuplo.com/learn/mcp/compatibility/clients/mcp-remote"
pageType: "mcp-client"
kind: "Bridge"
verified: "2026-07-31"
---

# mcp-remote 0.1.38

> The bridge that retrofits OAuth onto a client that lacks it, by presenting a remote server over stdio. Its `--transport` flag chooses which HTTP transport to try first, and it keeps a separate token cache per combination of URL, resource, and headers.

_Bridge. Protocol revision: `2025-11-25` at most._

## Support

- **stdio** — Yes
- **Streamable HTTP** — Yes
- **Legacy HTTP+SSE** — Yes
- **Protocol revision** — `2025-11-25` at most
- **Runs the OAuth flow** — Yes
- **Registration (RFC 7591)** — Yes
- **Metadata document** — Unknown
- **Pre-registered client ID** — Yes
- **Sends resource (RFC 8707)** — Unknown
- **Validates iss (RFC 9207)** — Unknown
- **Custom headers** — Yes

**Protocol revision.** `2025-11-25` at most. It pins version 1 of the TypeScript SDK, whose newest revision is `2025-11-25`.

## Caveats and sources

Each one names the column it qualifies and cites the page it comes from, which is often not the page in the row's primary source.

### Metadata document

Metadata documents, unconditional `resource`, and issuer validation all postdate this release: its README links the `2025-03-26` authorization specification, its last release is 0.1.38, and its last repository push was February 2026. The cells are unknown rather than absent because no document states it either way.

[Source](https://github.com/geelen/mcp-remote)

### Custom headers

Set with `--header`, with a documented workaround for a parsing bug: write the header with no spaces around the colon and put the spaces inside the environment variable instead.

[Source](https://github.com/geelen/mcp-remote)

[Primary source](https://github.com/geelen/mcp-remote)

_This row was last verified 2026-07-31 against the 2026-07-28 revision._

- **Clients** — [every client in the matrix](/learn/mcp/compatibility/clients)