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](https://smithery.ai/server/@runpod/runpod-mcp-ts):
Installation
Clone the repository
Install dependencies:
```
npm install
```
Build the server:
```
npm run build
```
Configuration
Set your RunPod API key as an environment variable:
You can get your API key from the [RunPod console](https://www.runpod.io/console/user/settings).
Running the Server
Start the server:
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:
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
Create a new pod
Create a serverless endpoint
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