Skip to content
MCP server

Relay

Run image, video, audio and LLM models on Relay's GPU network from your agent

Install
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.1.8
Listing updated
today

Similar MCP servers

About Relay

Relay is an MCP server for design and media. It can run locally on your machine or as a hosted remote server.

Tools here are generic and take the model name as a string, so a model added to Relay works without a new release. An agent can find a model, read its input schema, run it, poll long-running tasks, upload files, run workflows and search Relay's docs.

There are two ways to connect. The hosted Streamable HTTP server at mcp.relaygpu.com/mcp needs nothing installed and takes your key in an X-API-Key header or as a bearer token. The local stdio package @relaygpu/mcp runs with npx on Node 20 or newer and reads RELAY_API_KEY from its environment. Per the docs, the hosted server reads the key from each request and uses it for that request only.

Claude Desktop does not yet get remote OAuth from Relay, so it uses a one-click .mcpb bundle that runs the local server. The get_credits and get_usage tools need a dashboard JWT or a custom-tier superkey rather than a plain key.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.relaygpu.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.relaygpu.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.relaygpu.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.relaygpu.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.relaygpu.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.relaygpu.com/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • RELAY_API_KEYYour Relay API key (relay_sk_...) from dashboard.relaygpu.com/keys.Required

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

get_credits
Reads account credits (needs a dashboard JWT or superkey)
get_usage
Reads account usage (needs a dashboard JWT or superkey)

What it does

Model-agnostic tools
Tools accept the model as a string, so new Relay models need no server update.
Task polling
Start long image or video jobs and poll them until finished.
File upload
Upload inputs for models directly from the agent.
Workflow runs
Run Relay workflows through the server.
Docs search
Search Relay's documentation from the chat.
Hosted or local
Use the hosted endpoint or run the npm package over stdio.

Good for

  • Generate an image or video from a coding agent
  • Check which Relay models exist and read their input schema
  • Run a long task and poll until it completes
  • Look up Relay API docs without leaving the editor

Pricing

Pricing unknown

Model pricing is on Relay's site; server itself needs a Relay API key

Prices change. Check docs.relaygpu.com before you buy.

Relay FAQ

Do I need an API key?

Yes, a Relay key starting relay_sk_ from dashboard.relaygpu.com/keys.

Which clients are covered?

Claude Code, Codex, Cursor and VS Code use the hosted server; Claude Desktop uses a local bundle.

Does the server store my key?

The docs say no: the hosted server uses it per request, and the local one reads it from the environment.

What Node version does the local server need?

Node 20 or newer.

How do I add Relay to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.relaygpu.com/mcp

What are the best alternatives to Relay?

The closest alternatives to Relay are HyperFrames by HeyGen, headroom, omniget, next-ai-draw-io and mcp-for-blender.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers