RunPod MCP Server

Official
by runpod

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

  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: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
  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 "args": ["/path/to/runpod-mcp-server/build/index.js"] with the path to the build folder in the repository.

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

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Features
    1. Setup
      1. Prerequisites
      2. Installing via Smithery
      3. Installation
      4. Configuration
      5. Running the Server
    2. Setting up with Claude for Desktop
      1. Usage Examples
        1. List all pods
        2. Create a new pod
        3. Create a serverless endpoint
      2. Security Considerations
        1. License

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol (MCP) server implementation for interacting with Phabricator API. This server allows LLMs to interact with Phabricator through a standardized interface.
            Last updated -
            5
            Python
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that provides tools for managing providers, clients, tenants, and access tokens through the UseGrant platform.
            Last updated -
            26
            116
            JavaScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
            Last updated -
            TypeScript
            MIT License
            • Apple
            • Linux
          • -
            security
            -
            license
            -
            quality
            A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
            Last updated -
            2

          View all related MCP servers

          ID: jg4g7rn0yu