官方的 Runpod 模型上下文协议（MCP）服务器。它允许 Claude Code、Claude Desktop、Cursor、Windsurf、VS Code、opencode 和 Pi 等 MCP 客户端管理你的 Runpod Pods、无服务器端点、模板、网络卷等。

我们托管在https://mcp.runpod.io/——指向客户端的URL并用Runpod登录。无需安装，磁盘上没有API密钥。或者用npm本地运行，代码为@runpod/mcp-server。

快速开始

引导安装程序会检测你安装的客户端，询问要配置哪个，并为你编写配置：

它提供两种连接模式：

• 托管（推荐） — 将客户端指向托管服务器，并通过“用 Runpod 登录”（OAuth）进行认证。磁盘上不存储任何 API 密钥。
• 本地 — 通过npx运行服务器，并在客户端配置中存储RUNPOD_API_KEY。

稍后撤销：

要跳过提示（来自脚本、配置项或编码代理的壳），请命名客户端。支持的 ID 有 claude-code、cursor、windsurf、claude-desktop、vscode、opencode 和 pi：

没有 --client 且没有终端，安装程序会以代码 2 退出，且不配置任何东西。

Runpod MCP server

The official Runpod Model Context Protocol (MCP) server. It lets MCP clients such as Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, opencode, and Pi manage your Runpod Pods, Serverless endpoints, templates, network volumes, and more.

We host it for you at https://mcp.runpod.io/ — point your client at that URL and sign in with Runpod. Nothing to install, no API key on disk. Or run it locally from npm as @runpod/mcp-server.

Quick start

The guided installer detects the clients you have installed, asks which to configure, and writes the config for you:

npx @runpod/mcp-server@latest add

It offers two connection modes:

• Hosted (recommended) — points the client at the hosted server and authenticates with “Sign in with Runpod” (OAuth). No API key is stored on disk.
• Local — runs the server through npx and stores a RUNPOD_API_KEY in the client’s config.

To undo later:

npx @runpod/mcp-server@latest remove

To skip the prompts (from a script, CI, or a coding agent’s shell), name the clients. Supported ids are claude-code, cursor, windsurf, claude-desktop, vscode, opencode, and pi:

npx @runpod/mcp-server@latest add --client opencode,pi          # hosted, sign in with Runpod
npx @runpod/mcp-server@latest add --client cursor --local       # local, key read from RUNPOD_API_KEY
npx @runpod/mcp-server@latest remove --client opencode
npx @runpod/mcp-server@latest add --list                        # what's detected, and where each config lives

Without --client and without a terminal, the installer exits with code 2 and configures nothing. With flags it exits 0 when every client was configured and 1 when one failed.

Or install the whole Runpod plugin

For the full agent setup, the official plugin marketplace bundles this server with a router skill plus five more — runpod-mcp, runpodctl, flash, runpod-usage, and companion-clis:

npx skills add runpod/runpod-plugins-official

That works in Claude Code, Codex, Cursor, Copilot, Windsurf, Cline, Gemini, opencode, and 17+ other agents, and installs the skills — pair it with npx @runpod/mcp-server@latest add above for the control-plane tools.

In Claude Code, the native plugin route also wires up the hosted MCP server for you (OAuth included), so no separate setup is needed:

/plugin marketplace add runpod/runpod-plugins-official
/plugin install runpod@runpod

Requirements

• Node.js 20 or higher.
• A Runpod account and API key.

Connect to the hosted server

To configure a client by hand, point it at the hosted server over HTTP (no local process, no API key stored).

Claude Code:

claude mcp add --transport http runpod -s user https://mcp.runpod.io/