Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Cloud and hosting - official RunPod server

Runpod API MCP server

Official MCP server that wraps the Runpod REST API so AI tools can create and manage Pods, Serverless endpoints, templates, network volumes, container registries and billing through natural language. Available as a hosted server or a local npm package. RunPod hosts it at https://mcp.getrunpod.io/, or you can run @runpod/mcp-server (npm) locally with OAuth or API key auth.

Last verified 11 tools5 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add --transport http runpod -s user https://mcp.getrunpod.io/

Codex

About Codex
Terminal
codex mcp add runpod --url https://mcp.getrunpod.io/

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "your_api_key_here"
      }
    }
  }
}

Generic

JSON
{
  "mcpServers": {
    "runpod": {
      "url": "https://mcp.getrunpod.io/"
    }
  }
}

Tools

pod-action
Start, stop or restart a Pod, selected with an action argument (replaces start-pod/stop-pod/restart-pod from 3.x).
delete-pod
Delete a Pod; annotated as destructive so hosts can gate it on a human.
list-gpu-types
List GPU types; its pool value is used when creating Serverless endpoints.
purge-endpoint-queue
Purge a Serverless endpoint's queue; annotated as destructive.
create-registry
Create container registry auth (renamed from create-container-registry-auth).
list-billing
Return billing information (renamed from get-billing).
search-docs
Search Runpod documentation through the hosted server.
list-guides
List available Runpod guides.
read-guide
Read a Runpod guide by id.
lookup-concept
Look up a Runpod concept by name.
search-concepts
Search Runpod concepts by keywords.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Hosted server is the recommended path and uses a Sign in with Runpod OAuth flow that mints a session-scoped API key; an API key can be sent as a Bearer header instead.
  • Local server needs Node.js 20+ and RUNPOD_API_KEY.
  • Guided installer: npx @runpod/mcp-server@latest add.
  • The Cursor snippet is the local (API key) config; VS Code setup is documented as Command Palette steps, not a snippet.
  • Hosted server records anonymous per-tool-call analytics (opt out with header X-Runpod-Analytics: off).
  • Its firewall can temporarily block IPs that send bursts of unauthenticated requests (seen most with Codex sign-in); using an API key header avoids it. v4 is REST v2 only; several tool names changed from 3.x.
  • Tool list is partial: tools are generated from the v2 OpenAPI spec and the docs do not list them all.
  • Claude Code users can also get it via the runpod/runpod-plugins-official plugin.

More MCP servers for cloud and hosting

Related reading

FAQ

What does the Runpod API MCP server do?

Official MCP server that wraps the Runpod REST API so AI tools can create and manage Pods, Serverless endpoints, templates, network volumes, container registries and billing through natural language. Available as a hosted server or a local npm package. The vendor documents 11 tools, including pod-action, delete-pod, list-gpu-types and purge-endpoint-queue.

How do I add the Runpod API MCP server to Claude Code?

Run claude mcp add --transport http runpod -s user https://mcp.getrunpod.io/, copied from RunPod's docs. This page also has snippets for Codex, Cursor and Generic.

Does the Runpod API MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 5 RunPod pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.