From 10b7d4c575402ef36e24d14f3d88d14226f98275 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Tue, 27 Jan 2026 20:54:08 +0000 Subject: [PATCH 1/7] Add MCP servers documentation for Claude integration --- docs.json | 2 +- get-started/mcp-servers.mdx | 107 ++++++++++++++++++++++++++++++++++++ 2 files changed, 108 insertions(+), 1 deletion(-) create mode 100644 get-started/mcp-servers.mdx diff --git a/docs.json b/docs.json index eb5cb51c..99fe4211 100644 --- a/docs.json +++ b/docs.json @@ -41,7 +41,7 @@ "get-started/concepts", "get-started/manage-accounts", "get-started/api-keys", - "get-started/connect-to-runpod" + "get-started/mcp-servers" ] }, { diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx new file mode 100644 index 00000000..d7733a4d --- /dev/null +++ b/get-started/mcp-servers.mdx @@ -0,0 +1,107 @@ +--- +title: "Connect to Runpod MCP servers" +sidebarTitle: "Runpod MCP servers" +description: "Use to Runpod's MCP servers to manage resources and access documentation." +--- + +Runpod provides two Model Context Protocol (MCP) servers that connect AI tools and agents directly to Runpod. Use the API MCP server to manage your infrastructure, or the docs MCP server to get help with Runpod features. + +## Requirements + +- A [Runpod API key](/get-started/api-keys) (for the API server only). + +## Runpod API MCP server + +The Runpod API MCP server gives MCP-compatible tools access to the Runpod REST API, letting you create and manage Pods, Serverless endpoints, and other resources through natural language. + +You can find the source code [on GitHub](https://github.com/runpod/runpod-mcp). + +### Connect with Claude Code + +Run this command to install the Runpod API MCP server for Claude Code: + +```bash +npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude-code +``` + +When prompted, enter your Runpod API key. + +### Connect with Claude Desktop + +Run this command to install the Runpod API MCP server for Claude Desktop: + +```bash +npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude +``` + +When prompted, enter your Runpod API key. + +### Usage examples + +Once connected, you can ask your tool/agent to interact with your Runpod resources: + +**List all Pods** + +``` +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 +``` + +## Runpod docs MCP server + +The Runpod docs MCP server gives MCP-compatible tools access to Runpod documentation, making it easier to get answers about features and how to use them. + +The documentation MCP server is available at: + +``` +https://docs.runpod.io/mcp +```` + +### Connect with Claude Code + +Run this command to add the Runpod docs MCP server to Claude Code: + +```bash +claude mcp add --transport http runpod-docs --scope user https://docs.runpod.io/mcp +``` + +### Connect with Claude Desktop + +To connect Claude Desktop to the Runpod docs MCP server: + +1. Open [Claude](https://claude.ai/) in your browser and go to **Settings** by clicking your profile icon. +2. Select **Connectors** in the sidebar. +3. Scroll down and select **Add custom connector**. +4. Enter `https://docs.runpod.io/mcp` as the URL and select **Add**. +5. Complete any authentication prompts if required. + +### Usage examples + +Once connected, you can ask your tool/agent questions about Runpod features and documentation: + +``` +Explain the Runpod Serverless model caching feature +``` + +``` +How does global networking work? +``` From 5268e90fc9b07c9ea4d290872963e89c5cd8e98d Mon Sep 17 00:00:00 2001 From: Mo King Date: Tue, 27 Jan 2026 16:02:25 -0500 Subject: [PATCH 2/7] Revise MCP servers documentation for clarity Updated the title, sidebar title, and description for clarity. Changed 'Requirements' section to 'Benefits' and updated API key reference. --- get-started/mcp-servers.mdx | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx index d7733a4d..3ac2cead 100644 --- a/get-started/mcp-servers.mdx +++ b/get-started/mcp-servers.mdx @@ -1,14 +1,13 @@ --- title: "Connect to Runpod MCP servers" -sidebarTitle: "Runpod MCP servers" -description: "Use to Runpod's MCP servers to manage resources and access documentation." +sidebarTitle: "Connect to MCP" +description: "Manage Runpod resources and access documentation from within your favorite AI tools." --- Runpod provides two Model Context Protocol (MCP) servers that connect AI tools and agents directly to Runpod. Use the API MCP server to manage your infrastructure, or the docs MCP server to get help with Runpod features. -## Requirements +## Benefits -- A [Runpod API key](/get-started/api-keys) (for the API server only). ## Runpod API MCP server @@ -24,7 +23,7 @@ Run this command to install the Runpod API MCP server for Claude Code: npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude-code ``` -When prompted, enter your Runpod API key. +When prompted, enter your [Runpod API key](/get-started/api-keys). ### Connect with Claude Desktop From c417c5d7485db41e6db3f0ec52409c3ee235cd00 Mon Sep 17 00:00:00 2001 From: Mo King Date: Tue, 27 Jan 2026 16:07:56 -0500 Subject: [PATCH 3/7] Add benefits section --- get-started/mcp-servers.mdx | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx index 3ac2cead..9da3c762 100644 --- a/get-started/mcp-servers.mdx +++ b/get-started/mcp-servers.mdx @@ -8,6 +8,12 @@ Runpod provides two Model Context Protocol (MCP) servers that connect AI tools a ## Benefits +With Runpod's MCP servers, you can: + +- **Manage resources without leaving your workflow.** Create Pods, configure endpoints, and monitor deployments directly from your AI assistant. +- **Get contextual help when you need it.** Access Runpod documentation from within your coding environment. Your AI assistant can look up features, configuration options, and best practices while helping you build. +- **Automate complex tasks with simple requests.** Describe what you want in plain language, and let the AI handle the API calls. Chain multiple operations together without writing scripts. +- **Reduce errors and guesswork.** The AI assistant validates your requests against the actual API, catching issues before they cause problems. ## Runpod API MCP server @@ -39,14 +45,12 @@ When prompted, enter your Runpod API key. Once connected, you can ask your tool/agent to interact with your Runpod resources: -**List all Pods** +**Manage Pods** ``` List all my Runpod Pods ``` -**Create a new Pod** - ``` Create a new Runpod Pod with the following specifications: - Name: test-pod @@ -55,6 +59,10 @@ Create a new Runpod Pod with the following specifications: - GPU Count: 1 ``` +``` +Delete the Pod "test-pod" +``` + **Create a Serverless endpoint** ``` From 7bf8fc318caa71e9f16d6d6ae847d6bcd91776cd Mon Sep 17 00:00:00 2001 From: Mo King Date: Tue, 27 Jan 2026 16:08:21 -0500 Subject: [PATCH 4/7] Update --- get-started/mcp-servers.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx index 9da3c762..013d6263 100644 --- a/get-started/mcp-servers.mdx +++ b/get-started/mcp-servers.mdx @@ -1,5 +1,5 @@ --- -title: "Connect to Runpod MCP servers" +title: "Connect to Runpod's MCP servers" sidebarTitle: "Connect to MCP" description: "Manage Runpod resources and access documentation from within your favorite AI tools." --- From 8906713a3c8b9a562cc4eb3b2870b5fd49c263d2 Mon Sep 17 00:00:00 2001 From: Mo King Date: Tue, 27 Jan 2026 16:15:20 -0500 Subject: [PATCH 5/7] Update docs instructions --- get-started/mcp-servers.mdx | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx index 013d6263..af02a281 100644 --- a/get-started/mcp-servers.mdx +++ b/get-started/mcp-servers.mdx @@ -17,13 +17,13 @@ With Runpod's MCP servers, you can: ## Runpod API MCP server -The Runpod API MCP server gives MCP-compatible tools access to the Runpod REST API, letting you create and manage Pods, Serverless endpoints, and other resources through natural language. +The Runpod API MCP server gives MCP-compatible tools access to the [Runpod REST API](/api-reference/overview), letting you create and manage Pods, Serverless endpoints, and other resources through natural language. You can find the source code [on GitHub](https://github.com/runpod/runpod-mcp). ### Connect with Claude Code -Run this command to install the Runpod API MCP server for Claude Code: +Run this command to add the Runpod API MCP server to Claude Code: ```bash npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude-code @@ -33,7 +33,7 @@ When prompted, enter your [Runpod API key](/get-started/api-keys). ### Connect with Claude Desktop -Run this command to install the Runpod API MCP server for Claude Desktop: +Run this command to add the Runpod API MCP server to Claude Desktop: ```bash npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude @@ -77,11 +77,11 @@ Create a Runpod Serverless endpoint with the following configuration: The Runpod docs MCP server gives MCP-compatible tools access to Runpod documentation, making it easier to get answers about features and how to use them. -The documentation MCP server is available at: +The docs MCP server is available at: ``` https://docs.runpod.io/mcp -```` +``` ### Connect with Claude Code @@ -91,15 +91,14 @@ Run this command to add the Runpod docs MCP server to Claude Code: claude mcp add --transport http runpod-docs --scope user https://docs.runpod.io/mcp ``` -### Connect with Claude Desktop +### Connect with Claude (browser or desktop) -To connect Claude Desktop to the Runpod docs MCP server: +To connect to the Runpod docs MCP server with Claude (browser or desktop): -1. Open [Claude](https://claude.ai/) in your browser and go to **Settings** by clicking your profile icon. +1. Open [Claude Desktop](https://claude.ai/desktop) or [Claude in your browser](https://claude.ai/) and go to **Settings** by clicking your profile icon. 2. Select **Connectors** in the sidebar. 3. Scroll down and select **Add custom connector**. -4. Enter `https://docs.runpod.io/mcp` as the URL and select **Add**. -5. Complete any authentication prompts if required. +4. Enter `https://docs.runpod.io/mcp` as the URL and click **Add**. ### Usage examples From 4cd5f6d86210b44b27a54761525d17a40d50a282 Mon Sep 17 00:00:00 2001 From: Mo King Date: Wed, 28 Jan 2026 10:01:07 -0500 Subject: [PATCH 6/7] Add mcp to overview.mdx --- get-started/mcp-servers.mdx | 4 ++-- overview.mdx | 11 ++++++----- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx index af02a281..7301a347 100644 --- a/get-started/mcp-servers.mdx +++ b/get-started/mcp-servers.mdx @@ -26,7 +26,7 @@ You can find the source code [on GitHub](https://github.com/runpod/runpod-mcp). Run this command to add the Runpod API MCP server to Claude Code: ```bash -npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude-code +npx -y @smithery/cli install @runpod/runpod-mcp --client claude-code ``` When prompted, enter your [Runpod API key](/get-started/api-keys). @@ -36,7 +36,7 @@ When prompted, enter your [Runpod API key](/get-started/api-keys). Run this command to add the Runpod API MCP server to Claude Desktop: ```bash -npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude +npx -y @smithery/cli install @runpod/runpod-mcp --client claude ``` When prompted, enter your Runpod API key. diff --git a/overview.mdx b/overview.mdx index 04164cd3..d5edd92b 100644 --- a/overview.mdx +++ b/overview.mdx @@ -20,8 +20,8 @@ If you're new to Runpod, start here to learn the essentials and deploy your firs Create API keys to manage your access to Runpod resources. - - Explore various methods for accessing and managing Runpod resources. + + Connect your AI tools to Runpod's MCP servers to manage resources and access docs. @@ -47,12 +47,13 @@ Serverless provides pay-per-second computing with automatic scaling for producti Learn how Serverless billing works and how to optimize your costs. + + Write a handler function, build a worker image, create an endpoint, and send your first request. + Deploy a large language model for text or image generation in minutes using vLLM. - - Build a custom worker and deploy it as a Serverless endpoint. - + ## Pods From a28a269c2b0c2bf2d066b3364cc7f43c5d7cecb1 Mon Sep 17 00:00:00 2001 From: Mo King Date: Wed, 28 Jan 2026 10:01:26 -0500 Subject: [PATCH 7/7] update --- get-started/mcp-servers.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/get-started/mcp-servers.mdx b/get-started/mcp-servers.mdx index 7301a347..af02a281 100644 --- a/get-started/mcp-servers.mdx +++ b/get-started/mcp-servers.mdx @@ -26,7 +26,7 @@ You can find the source code [on GitHub](https://github.com/runpod/runpod-mcp). Run this command to add the Runpod API MCP server to Claude Code: ```bash -npx -y @smithery/cli install @runpod/runpod-mcp --client claude-code +npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude-code ``` When prompted, enter your [Runpod API key](/get-started/api-keys). @@ -36,7 +36,7 @@ When prompted, enter your [Runpod API key](/get-started/api-keys). Run this command to add the Runpod API MCP server to Claude Desktop: ```bash -npx -y @smithery/cli install @runpod/runpod-mcp --client claude +npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude ``` When prompted, enter your Runpod API key.