ld
Clients

MCP relays

Reverse-proxy remote MCP servers with injected, encrypted credentials.

MCP relays let coding agents reach remote MCP (Model Context Protocol) HTTP servers through llama-dash, so the provider bearer token stays encrypted in the credential vault and every exchange is logged.

Relays live at /mcp-relays/:slug. A relay request must include x-llama-dash-api-key, and that key must explicitly allow the relay. The stored upstream credential is then injected into outbound headers, the response streams through, and the exchange is logged without exposing the provider secret. Successful relay requests are metadata-only by default; failures keep bounded debug capture.

MCP relay request flowalt [key is not allowed for relay][key is allowed]MCP HTTP requestx-llama-dash-api-key: sk-...Validate key and relay allow-listdeny403 ForbiddenStore failed relay attemptallowLoad encrypted upstream credentialDecrypted bearer tokenForward MCP requestinject upstream AuthorizationStream MCP responseStream responseStore relay metadataredact provider secretCoding agentllama-dash/mcp-relays/:slugAPI key policyCredential vaultRemote MCP serverRelay log

Configure a client

Create the relay in Policies, then point your client at the relay URL with a separate llama-dash key header. The Policies page shows this snippet for each configured relay:

{
  "mcpServers": {
    "hyperline_sandbox": {
      "type": "http",
      "url": "http://<llama-dash-host>:3000/mcp-relays/hyperline-sandbox",
      "headers": {
        "x-llama-dash-api-key": "sk-..."
      }
    }
  }
}

The provider bearer is injected only when an API key that is explicitly allowed to use the relay forwards the request upstream.

Relays require CREDENTIAL_ENCRYPTION_KEY to be set — they rely on the encrypted credential vault.

Last updated on

On this page