Skip to content

docs: Add MCP servers documentation#515

Merged
muhsinking merged 12 commits intomainfrom
promptless/mcp-servers-claude-integration
Feb 24, 2026
Merged

docs: Add MCP servers documentation#515
muhsinking merged 12 commits intomainfrom
promptless/mcp-servers-claude-integration

Conversation

@promptless
Copy link
Contributor

@promptless promptless bot commented Jan 27, 2026

Open this suggestion in Promptless to view citations and reasoning process

Created a new integration guide documenting the Runpod MCP servers for Claude. The page covers both the Runpod API MCP server (for managing Pods and Serverless endpoints via natural language) and the Runpod docs MCP server (for accessing documentation). Includes setup instructions for Claude Desktop and Claude Code, along with usage examples.

Trigger Events

Internal discussion about creating a getting started documentation page for setting up Runpod API and Runpod docs MCP servers with Claude Desktop and Claude Code.

Agent Response

I've created a new documentation page for the MCP servers. Here's a summary of the changes:

What I created

New page: integrations/mcp-servers.mdx

This page documents both MCP servers for connecting Claude to Runpod:

  1. Runpod API MCP server - Covers installation via Smithery CLI for both Claude Desktop and Claude Code, with usage examples for listing Pods, creating Pods, and creating Serverless endpoints.

  2. Runpod docs MCP server - Includes setup instructions for Claude Code (CLI command) and Claude Desktop (step-by-step connector configuration), with example prompts for querying documentation.

The page includes a Requirements section linking to the API keys documentation, and follows the integration docs structure used by other pages like dstack and mods.

Updated docs.json - Added the new page to the Integrations navigation group under Reference.

The suggestion is ready for your review: https://app.gopromptless.ai/change-history/7047e083-0807-4c73-9b63-d9f14ea9f0bf


Help us improve Promptless — If this suggestion missed the mark, please share quick feedback.

If you want Promptless to make further changes on this PR, feel free to leave a comment tagging Promptless (It won't show up in the user drop down but Promptless will get it!)

Updated the title, sidebar title, and description for clarity. Changed 'Requirements' section to 'Benefits' and updated API key reference.
@muhsinking muhsinking changed the title docs: Add MCP servers documentation for Claude integration docs: Add MCP servers documentation Jan 27, 2026
@muhsinking muhsinking requested a review from max4c January 27, 2026 21:09
- Replace all Smithery CLI commands with native client setup instructions
- Fix npm package from @runpod/runpod-mcp-ts (Smithery-only name) to
  @runpod/mcp-server (actual npm package)
- Claude Code: use `claude mcp add` with --scope user for global install
- Add setup instructions for Windsurf, Cline, Gemini CLI, and OpenAI Codex CLI
- Claude Desktop, Cursor, VS Code with Copilot sections updated with correct package

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Restructure page around the two servers (API + docs) with client
  configs nested under each, modeled after Vercel's MCP docs layout
- Add anchor links at top for quick navigation between servers
- Add setup instructions for Codex CLI, Windsurf, Cline, Gemini CLI
- Use native CLI commands for Claude Code and Codex CLI instead of
  manual config file editing
- Remove Benefits, Available tools accordion, Advanced usage,
  Troubleshooting, Security best practices, and Related resources
- Page reduced from 514 to ~300 lines

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@max4c
Copy link
Collaborator

max4c commented Feb 24, 2026

Hey Mo, I made some updates to this PR. Here's what changed:

Fixes:

  • Removed Smithery. Replaced all npx @smithery/cli install commands with native client setup (claude mcp add, codex mcp add, JSON configs). Smithery was installing at project-local scope and added an unnecessary dependency.
  • Fixed npm package name from @runpod/runpod-mcp-ts (Smithery registry name that doesn't exist on npm) to @runpod/mcp-server (the actual published package). Verified it works end-to-end.

Additions:

  • Added setup instructions for Codex CLI, Windsurf, Cline, and Gemini CLI (modeled after Vercel's MCP docs).
  • Updated Cursor section to mention both Cursor IDE and Cursor Agent.

Trimmed:

  • Removed Benefits, Available tools accordion, Advanced usage, Troubleshooting, Security best practices, and Related resources sections. Page went from 514 to ~300 lines.
  • Restructured around the two servers (API + docs) with client configs nested under each, instead of a separate Setup section.
  • Added anchor links at the top so readers can jump straight to either server.

Also opened a matching PR on runpod-mcp to update the README with the same changes: runpod/runpod-mcp#15

@promptless
Copy link
Contributor Author

promptless bot commented Feb 24, 2026

Just a reminder: If you'd like me to act on any feedback you have via Github comments, just type @Promptless in your suggestion and I'll get right on it! (I won't show up in the user dropdown, but I'll process any request that has @Promptless in the comment body.)

@muhsinking muhsinking merged commit 79bfdb5 into main Feb 24, 2026
3 checks passed
@muhsinking muhsinking deleted the promptless/mcp-servers-claude-integration branch February 24, 2026 21:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants