RunPod MCP Server

This Model Context Protocol (MCP) server enables you to interact with the RunPod REST API through Claude or other MCP-compatible clients.

Features

The server provides tools for managing:

Pods: Create, list, get details, update, start, stop, and delete pods
Endpoints: Create, list, get details, update, and delete serverless endpoints
Templates: Create, list, get details, update, and delete templates
Network Volumes: Create, list, get details, update, and delete network volumes
Container Registry Authentications: Create, list, get details, and delete authentications

Setup

Prerequisites

Node.js 18 or higher
A RunPod account and API key
Claude for Desktop or another MCP-compatible client

Installing via Smithery

To install runpod-mcp-ts for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude

Installation

Clone the repository
Install dependencies:
npm install
Build the server:
npm run build

Configuration

Set your RunPod API key as an environment variable:

# Linux/macOS
export RUNPOD_API_KEY=your_api_key_here

# Windows (Command Prompt)
set RUNPOD_API_KEY=your_api_key_here

# Windows (PowerShell)
$env:RUNPOD_API_KEY="your_api_key_here"

You can get your API key from the RunPod console.

Running the Server

Start the server:

npm start

Setting up with Claude for Desktop

Open Claude for Desktop
Edit the config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Add the server configuration:

{
  "mcpServers": {
    "runpod": {
      "command": "node",
      "args": ["/path/to/runpod-mcp-server/build/index.js"],
      "env": {
        "RUNPOD_API_KEY": "your_api_key_here"
      }
    }
  }
}

Make sure to replace the "args": ["/path/to/runpod-mcp-server/build/index.js"] with the path to the build folder in the repository.

Restart Claude for Desktop

Usage Examples

Here are some examples of how to use the server with Claude:

List all pods

Can you list all my RunPod pods?

Create a new pod

Create a new RunPod pod with the following specifications:
- Name: test-pod
- Image: runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04
- GPU Type: NVIDIA GeForce RTX 4090
- GPU Count: 1

Create a serverless endpoint

Create a RunPod serverless endpoint with the following configuration:
- Name: my-endpoint
- Template ID: 30zmvf89kd
- Minimum workers: 0
- Maximum workers: 3

Security Considerations

This server requires your RunPod API key, which grants full access to your RunPod account. For security:

Never share your API key
Be cautious about what operations you perform
Consider setting up a separate API key with limited permissions
Don't use this in a production environment without proper security measures

License

MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

This Model Context Protocol server enables interaction with RunPod's REST API through Claude or other MCP-compatible clients, providing tools for managing pods, endpoints, templates, network volumes, and container registry authentications.

Related MCP Servers

API Tester MCP Server
Vikrant-Khedkar
-
security
F
license
-
quality
A Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.
Last updated -
Python
Mattermost MCP Server
Wagmi-Tech-Co
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to interact with Mattermost instances, supporting post management, channel operations, user management, and reaction management.
Last updated -
1
1
TypeScript
MIT License
my-mcp-server
15972289829
A
security
F
license
A
quality
A Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.
Last updated -
340
TypeScript
My MCP Server
goodafternoonoo
A
security
F
license
A
quality
A customizable Model Context Protocol server built with mcp-framework that enables Claude to access external tools and capabilities through a standardized interface.
Last updated -
340
TypeScript

View all related MCP servers

RunPod MCP Server