RunPod MCP server

The RunPod MCP Server lets you interact with the RunPod REST API through Claude or other MCP-compatible clients, giving you programmatic control over pods, endpoints, templates, volumes, and more.

Features

This 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

Installation

Prerequisites

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

Installing via Smithery

The easiest way to install the RunPod MCP server is through Smithery:

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

Manual Installation

If you prefer to install manually:

1. Clone the repository
2. Install dependencies:

   npm install
   

3. 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

1. Open Claude for Desktop
2. Edit the config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 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 /path/to/runpod-mcp-server/build/index.js with the actual path to the build folder in the repository.

4. Restart Claude for Desktop

Usage Examples

List all pods

Simply ask Claude:

Can you list all my RunPod pods?

Create a new pod

Ask Claude to create a pod with specific parameters:

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

Ask Claude to set up 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

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.