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
Quick Start
Prerequisites
- Node.js 18 or higher
- A Runpod account and API key (get your API key)
Running with npx
You can run the server directly without installation:
RUNPOD_API_KEY=your_api_key_here npx @runpod/mcp-server@latest
Installing via Smithery
To install for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude
Setting up with Claude for Desktop
- Open Claude for Desktop
- Edit the config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Add the server configuration:
{
"mcpServers": {
"runpod": {
"command": "npx",
"args": ["@runpod/mcp-server@latest"],
"env": {
"RUNPOD_API_KEY": "your_api_key_here"
}
}
}
}
- Restart Claude for Desktop
Usage Examples
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
Apache-2.0