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%Claudeclaude_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
RunPod
Project Details
- runpod/runpod-mcp-ts
- MIT License
- Last Updated: 4/17/2025
Categories
Recomended MCP Servers
MCP Server for AI Agent Marketplace Index from DeepNLP
MCP Hyperliquid (https://app.hyperliquid.xyz) server
Enable AI assistants to search and access bioRxiv papers through a simple MCP interface.
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images
Implementation of an MCP (Model Context Protocol) Server for SQLite. It provides an AI model with context and...
中国传统黄历 MCP 服务 | Chinese Traditional Almanac MCP Service
Full implementation of Todoist Rest API & support Todoist Sync API for MCP server
The Ultimate Model Context Protocol (MCP) Server, providing unified access to a wide variety of useful and powerful...
A Model Context Protocol (MCP) server for integrating Perplexity's AI API with LLMs.
A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.
Firefly MCP