PlugWiki
runpod-mcp logo

Runpod MCP server

OfficialRemoteLocal
Getnpm@runpod/mcp-serverrunpod/runpod-mcp

Lets your AI assistant create, run and manage Runpod GPU Pods, Serverless endpoints, storage and billing.

This is Runpod's own server. Point your client at the hosted address and sign in with Runpod, or run it on your machine with an API key.

Your assistant can start, stop and delete Pods, deploy endpoints, send jobs, read logs and check spend. Pods, endpoints, clusters and volumes cost money while they exist, and delete tools remove them for good. Use it with a key and a client that asks before each change.

Good for

  • ML engineers who rent GPUs on Runpod
  • Developers deploying Serverless endpoints
  • Teams that track GPU spend

Works in

14 should work

Tap an app to see how to set it up and any known problems.

Install runpod MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the runpod MCP server to Claude Code. Run this command:
    
    claude mcp add --transport http runpod -s user https://mcp.runpod.io/
    
    Ask me for RUNPOD_API_KEY and only put the values in that config, nowhere else.
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

The hosted address asks you to sign in with Runpod the first time, so no API key is stored on your machine. The local version needs Node.js 20 or higher and a Runpod API key. The plugin route and the .mcp.json config are not tied to the hosted or local choice above them; the plugin wires up the hosted server. The .mcp.json snippet is generated from the README command.

From the project README. Source.

Tools

  • Lists your Pods

    Returns the Pods in your account, newest first. Pods that belong to a cluster are left out unless you ask for them.

    Try: “Show me all my Runpod Pods and which are running.”

    Read · list-pods

  • Shows one Pod in detail

    Returns a single Pod by its id, including its status, hardware and which actions are allowed right now.

    Try: “Get the details of my pod abc123, including its status.”

    Read · get-pod

  • Lists your Serverless endpoints

    Returns a trimmed summary of each Serverless endpoint: name, image, compute setup, worker counts, scaling and data centers.

    Try: “Which Serverless endpoints do I have, and how many workers does each run?”

    Read · list-endpoints

  • Shows one Serverless endpoint

    Returns the full record of one Serverless endpoint by its id.

    Try: “Show the full config of my endpoint my-endpoint.”

    Read · get-endpoint

  • Lists your templates

    Returns each template you can see with its name, image and whether it is for Serverless, 20 per page.

    Try: “List my Runpod templates.”

    Read · list-templates

  • Shows one template

    Returns the full container setup of a template, whether it is yours or from the public catalog.

    Try: “Show me the setup of my pytorch template.”

    Read · get-template

  • Browses the public template catalog

    Lists templates Runpod curated, templates the community shared, or ones Runpod has verified, for both Pods and Serverless.

    Try: “Find an official Runpod template for ComfyUI.”

    Read · list-public-templates

  • Lists your network volumes

    Returns the network-attached storage volumes you own, newest first.

    Try: “What network volumes do I have and how big are they?”

    Read · list-network-volumes

  • Shows one network volume

    Returns one network volume by id.

    Try: “Show details for network volume nv-123.”

    Read · get-network-volume

  • Lists your global volumes

    Returns your global volumes, the storage that mounts in any data center.

    Try: “List my global volumes.”

    Read · list-global-volumes

  • Shows one global volume

    Returns one global volume by id.

    Try: “Show my global volume called datasets.”

    Read · get-global-volume

  • Lists your Instant Clusters

    Returns the multi-Pod clusters you own, newest first.

    Try: “Do I have any Instant Clusters running?”

    Read · list-clusters

Read from the source code

Permissions

high risk · 5 things to watch

High risk

It can rent billable GPUs and permanently delete Pods, endpoints, clusters, volumes and secrets in your Runpod account. Approve each change by hand, and use a client that shows tool calls before they run.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete Pods, endpoints and volumes

    Several tools delete or terminate resources for good, including delete-pod, delete-endpoint, delete-cluster and delete-network-volume. Set your client to ask before each call. github.com

  • It can start billable GPUs

    create-pod, create-endpoint, create-cluster and create-network-volume start charges that run until you stop or delete them. The server text tells the assistant to quote the price first, but nothing in the code stops a call. github.com

  • It acts with your full account rights

    The README says the server acts with the full permissions of the key or sign-in. There is no read-only switch. github.com

  • It tells the assistant to load playbooks first

    The server instructions say to read a routed guide before the first Runpod call and call a reply without it out of contract. Expect extra guide reads at the start of a session.

  • The hosted server records anonymous tool use

    It logs tool name, status, duration and transport for each call, and drops arguments except on guide and concept tools. Send the X-Runpod-Analytics: off header to opt out. The local server sends none of this, but docs search still goes to the hosted server. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toapi.runpod.io. api.runpod.ai. mcp.runpod.io (docs search)
Scopes
  • Runpod account (acts with the permissions of the signed-in account or the API key)

Questions

Is the Runpod MCP server official?

Yes. Runpod publishes it from its own GitHub organization, and the README calls it the official Runpod MCP server.

Do I need an API key?

Not for the hosted server. You sign in with your Runpod account and the server gets a key scoped to that session. The local version needs a Runpod API key from your account settings. You can also send your own key to the hosted server in an Authorization header.

What is the Runpod MCP server URL?

The hosted address is https://mcp.runpod.io/. Add it as a remote server in your client and approve the Runpod sign-in.

Hosted or local, which should I pick?

Hosted is the one the README recommends, since nothing is stored on your machine. Pick local if you want the server to run as your own process. Both call the Runpod API with your account rights.

Which account does the sign-in use?

The one your browser console session has selected when you approve. If you belong to several teams, switch to the right profile in the Runpod console first.

Can it run read-only?

No read-only switch is documented. Every tool carries read-only and destructive hints, so a client can auto-approve reads and ask you before deletes.

Can it delete my Pods?

Yes. It can terminate Pods and delete endpoints, clusters, volumes and secrets for good. Keep your client set to ask before each change.

Why does sign-in fail with HTTP 403?

The hosted firewall can block your IP for up to an hour after a burst of unauthenticated requests, often from Codex. Wait, then use your API key in a header instead of OAuth.

Is this the full list of tools?

The page lists the tools the local npm package registers. The hosted server also offers feedback and journal tools that send notes to Runpod, and a smaller set is served to the ChatGPT and Claude directory listings.

Information

updated Nov 2, 2026

Publisher
Official
Package
@runpod/mcp-server
Registry
npm
Transport
stdio, Streamable HTTP
Auth
OAuth
Version
4.9.0
License
Apache-2.0
Last commit
Oct 30, 2026
Open issues
2

WebsiteGitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. Runpod MCP server README · github.com
  2. @runpod/mcp-server 4.9.0 (dist and changelog) · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.