{
  "markdown": "# Runpod Official Plugins\n\nThe **official** plugin marketplace of skills for AI agents to manage GPU workloads on Runpod —\npods, serverless endpoints, jobs, templates, and volumes — via the Runpod MCP\nserver, `runpodctl`, and `flash`.\n\nThis repo ships **one plugin**, [`runpod`](plugins/runpod/), with eight skills total:\none router plus seven lanes, the hosted Runpod MCP server config, and worked golden paths.\n\n**Compatibility:** installs as a native plugin in **Claude Code, Codex, Gemini,\nand opencode** (with auto-update), and as skills via **skills.sh** for Cursor,\nCopilot, Windsurf, Cline, and 17+ other agents — all from the same manifest.\n\n## Quick start\n\n**Install** — works with every agent (Claude Code, Codex, Cursor, Copilot, Windsurf, Cline,\nGemini, opencode, +more). The first line is all you need; drop any others you won't use:\n\n```bash\nnpx skills add runpod/runpod-plugins-official # the skills — any agent (essential)\ncurl -sSL https://cli.runpod.net | bash       # runpodctl — infra CLI (or: brew install runpod/runpodctl/runpodctl)\nuv tool install runpod-flash                  # flash — deploy your own code (optional; or: pip install runpod-flash)\nnpx @runpod/mcp-server@latest add            # hosted MCP server — guided setup, OAuth (optional)\n```\n\nThen authenticate — one API key covers everything (from\n[the console](https://runpod.io/console/user/settings)):\n\n```bash\nexport RUNPOD_API_KEY=<key>      # current shell only — add to ~/.zshrc (or ~/.bashrc) to persist\n# or, to save it permanently:\nrunpodctl doctor                 # prompts for the key and writes ~/.runpod/config.toml\n```\n\nNow just ask in plain English — the skill drives the tools for you:\n\n> *\"list my Runpod endpoints\"*  ·  *\"spin up an A100 pod\"*  ·  *\"deploy this handler to serverless\"*\n\nThat's it. Notes:\n- **Claude Code** can install natively instead (auto-wires the hosted **MCP server** + OAuth) —\n  see [Install → Claude Code](#claude-code). MCP auth details: [Authentication](#authentication).\n- Companion CLIs (`docker`/`gh`/`hf`/`aws`) install separately, per task — see\n  [`companion-clis`](plugins/runpod/skills/companion-clis/SKILL.md).\n\n## Install\n\nSame repo, one manifest — pick your agent below. Every route installs the same\neight skills (one router plus seven lanes), plus a hosted **Runpod MCP server** for\ncontrol-plane tools.\nThen [authenticate](#authentication).\n\n### Claude Code\n\n```\n/plugin marketplace add runpod/runpod-plugins-official\n/plugin install runpod@runpod\n/reload-plugins\n```\n\nInstalling **also wires up the hosted Runpod MCP server** (via the bundled\n[`.mcp.json`](plugins/runpod/.mcp.json)) — no separate MCP setup. Authenticate it:\n`/mcp` → **runpod** → *Sign in with Runpod* (OAuth; no key on disk).\n\n**Verify:** `/plugin` shows **Runpod** under *Installed*; then ask *\"list my Runpod\nendpoints\"* — it should call the MCP `list-endpoints` tool.\n\n### Codex\n\n```bash\ncodex plugin marketplace add https://github.com/runpod/runpod-plugins-official.git\ncodex /plugins        # → open the \"Runpod\" marketplace tab → Runpod → Install (reload if prompted)\n```\n\nManage the source: `codex plugin marketplace list` · `… upgrade runpod` · `… remove runpod`.\n\nCodex may **not** auto-wire the bundled MCP — if the `runpod` MCP tools don't appear\nafter install, add the hosted server manually:\n\n```bash\ncodex mcp add runpod --transport http https://mcp.getrunpod.io/\n```\n\n**Verify:** ask a Runpod task (the skill/router should answer); once the MCP is added,\n*\"list my Runpod endpoints\"* should call a tool.\n\n### Everything else — Cursor, Copilot, Windsurf, Cline, opencode, Gemini (+17)\n\nInstall the skills via **skills.sh** (reads the same\n[`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json)):\n\n```bash\nnpx skills add runpod/runpod-plugins-official\n# just one skill:\nnpx skills add https://github.com/runpod/runpod-plugins-official/tree/main/plugins/runpod/skills/runpodctl\n```\n\nGemini can also install natively via the bundled\n[`gemini-extension.json`](plugins/runpod/gemini-extension.json) (see your client's\nextension docs). For these clients, add the **MCP server** yourself — the guided\ninstaller configures most agents:\n\n```bash\nnpx @runpod/mcp-server@latest add     # detects your agent + sets up the hosted MCP (OAuth)\n```\n\nSee [`runpod-mcp/SKILL.md`](plugins/runpod/skills/runpod-mcp/SKILL.md) for hosted vs\nlocal (stdio) MCP setup and all client options.\n\n## Authentication\n\nAuth is needed in **two places**, and **one Runpod API key covers both**:\n\n| What | What it needs | How |\n| --- | --- | --- |\n| `runpodctl` + `flash` (the CLIs) | `RUNPOD_API_KEY` (env or saved) | `export RUNPOD_API_KEY=<key>`, or `runpodctl doctor` to save it |\n| Hosted **Runpod MCP** server (infra tools) | OAuth **or** the same key | `/mcp` sign-in, **or** pass the key as a Bearer header |\n\n**Fastest path — one key, everything:**\n\n1. **Get an API key:** [Runpod console → Settings → API Keys](https://runpod.io/console/user/settings).\n2. **Make it available to the CLIs** (`runpodctl`, `flash`) — either way works:\n   ```bash\n   export RUNPOD_API_KEY=<key>   # this shell only; add to ~/.zshrc / ~/.bashrc to persist\n   runpodctl doctor              # OR: prompts once and saves to ~/.runpod/config.toml (persistent)\n   ```\n3. **Authenticate the MCP server** — pick one:\n   - **OAuth (easiest, no key on disk):** in Claude Code, `/mcp` → **runpod** → *Sign in with Runpod*.\n   - **Reuse the key you just set:**\n     ```bash\n     claude mcp add --transport http runpod -s user https://mcp.getrunpod.io/ \\\n       --header \"Authorization: Bearer $RUNPOD_API_KEY\"\n     ```\n\nCodex and local-stdio MCP variants are in [`runpod-mcp`](plugins/runpod/skills/runpod-mcp/SKILL.md).\nCompanion CLIs (`hf`, `docker`, `gh`, `aws`) use their own credentials — see\n[`companion-clis`](plugins/runpod/skills/companion-clis/SKILL.md). If nothing is set up, the\n`runpod` skill detects it and walks you through this.\n\n## Updating\n\nThe plugin is **versioned**: updates arrive when we cut a release (a version bump, see\nthe CHANGELOG). Claude Code pulls the new version in the background; if it hasn't picked\nit up yet, force it manually:\n\n| Client | Update command |\n| --- | --- |\n| **Claude Code** | `/plugin marketplace update runpod` then `/reload-plugins` |\n| **Codex** | `codex plugin marketplace upgrade runpod` |\n| **skills.sh** | re-run `npx skills add runpod/runpod-plugins-official` |\n\n## Uninstall\n\nRemove the plugin (and, where applicable, the marketplace it came from):\n\n| Client | Uninstall |\n| --- | --- |\n| **Claude Code** | `/plugin uninstall runpod@runpod`, then `/plugin marketplace remove runpod` |\n| **Codex** | `codex plugin marketplace remove runpod` |\n| **skills.sh** | `npx skills remove runpod` |\n\nIf a command reports a name mismatch, list what's installed first —\n`/plugin marketplace list` (Claude Code) · `codex plugin marketplace list` (Codex) ·\n`npx skills list` (skills.sh) — and use the name shown. Removing the marketplace also drops\nthe bundled hosted-MCP registration it added; if you configured the MCP separately, remove\nthat too (Claude Code: `claude mcp remove runpod`).\n\n## What's inside\n\nStart with the **`runpod`** router; it points at the right lane.\n\n| Skill | Use it for |\n| --- | --- |\n| [`runpod`](plugins/runpod/skills/runpod/SKILL.md) | Router / entrypoint. Start here when the right skill is unclear. |\n| [`runpod-mcp`](plugins/runpod/skills/runpod-mcp/SKILL.md) | Manage infra via the Runpod **MCP server**'s structured tool calls. |\n| [`runpodctl`](plugins/runpod/skills/runpodctl/SKILL.md) | Manage infra from the **CLI**, plus Hub, file transfer, SSH, `doctor`. |\n| [`flash`](plugins/runpod/skills/flash/SKILL.md) | **Write and deploy your own code** on Runpod serverless (`@remote`). |\n| [`companion-clis`](plugins/runpod/skills/companion-clis/SKILL.md) | Prerequisite CLIs: `hf`, `docker`, `gh`, `aws`. |\n| [`runpod-usage`](plugins/runpod/skills/runpod-usage/SKILL.md) | **Concepts** — pods/serverless, containers, storage, GPU selection, gotchas. |\n| [`runpod-templates`](plugins/runpod/skills/runpod-templates/SKILL.md) | **Official pod templates** — what each image ships, ports/paths, readiness, gotchas. |\n| [`runpod-migrate`](plugins/runpod/skills/runpod-migrate/SKILL.md) | **Migrate code** from the GraphQL API or REST v1 to REST v2. |\n\nSee the plugin's [README](plugins/runpod/README.md) for the full guide, the\ndevelopment loop, and setup. Worked end-to-end examples live in\n[`plugins/runpod/skills/runpod/golden-paths/`](plugins/runpod/skills/runpod/golden-paths/).\n\n## Ask for it by name\n\nPlain English works for one-off actions. For anything you're **designing**, add one\nclause — *\"and look at the examples first\"*:\n\n- *\"Use the Runpod plugin skills and look at the examples. I want to build a speech\n  translator: audio in, translated text out. Plan it out.\"*\n- *\"Use the runpod-migrate skill to move this repo from GraphQL to REST v2. Show me\n  the inventory before you change anything.\"*\n- *\"Use the Runpod skills to repair the missing model links in this ComfyUI workflow, then download the approved files to my Pod.\"*\n- *\"Use the Runpod skills and check the examples — deploy this handler to serverless.\"*\n- *\"Use the Runpod skills — cheapest GPU that fits a 13B model?\"*\n- *\"Use the Runpod skills and check the examples — my endpoint returns `IN_QUEUE` forever.\"*\n\nYou don't need to know which example applies; the agent picks. Worth adding either\nway: *\"show me the plan before you change anything\"* and *\"verify it with a real\nrequest\"* (\"Running\" is not \"ready\").\n\n**Why the extra clause helps.** Skills auto-load from their description, but the\n[golden paths](plugins/runpod/skills/runpod/golden-paths/) deliberately have **no\n`SKILL.md`**, so agents never load them on their own — and each skill's\n`reference/*.md` opens only on demand. Asking is what pulls them in, and they're\nwhere the commands that were actually run against a real account live.\n\n## Repository layout\n\n```\n.claude-plugin/marketplace.json   Claude Code / skills.sh marketplace manifest\n.agents/plugins/marketplace.json  Codex marketplace manifest\nplugins/runpod/                   the plugin (skills/ incl. runpod/golden-paths/, .mcp.json, manifests)\nhooks/                            marketplace, branding & link validation\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nApache-2.0\n",
  "bytes": 10377,
  "sha": "be98264cef0b1e2ca4fc554bf202fb4d1f8118747047a5f04fda06268ed2408e",
  "repo_slug": "runpod/runpod-plugins-official",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_runpod_runpod_plugins_official_runpod_mc_4aeb3a2e/readme"
}