Skip to content
Back to search

apipod-agent-plugins

MarketplaceWorks with Claude CodeGitHub

APIPod plugins for AI assistants: image and video generation, cost estimates and balance through the APIPod MCP server.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/geniuspath--apipod-agent-plugins/badge.svg)](/listings/geniuspath--apipod-agent-plugins)

HTML

<a href="/listings/geniuspath--apipod-agent-plugins"><img src="/api/listings/geniuspath--apipod-agent-plugins/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

claude plugin marketplace add geniuspath/apipod-agent-plugins
claude plugin install apipod@apipod-agent-plugins

Then run `/mcp`, select **apipod**, and sign in with the browser.

Claude web / Desktop

Add a custom connector with the URL `https://api.apipod.ai/mcp` (Customize → Connectors), sign in, and start a new chat. The skills in this repo are optional there; the server's own instructions cover the basics.

ChatGPT

Add a custom connector with the URL `https://api.apipod.ai/mcp/chatgpt` (Settings → Connectors → Advanced, developer mode), sign in, then start a chat. The `/chatgpt` surface keeps top-up links out of the conversation.

Codex

codex plugin marketplace add geniuspath/apipod-agent-plugins
codex plugin add apipod@apipod-agent-plugins

Or register the server directly:

codex mcp add apipod --url https://api.apipod.ai/mcp
codex mcp login apipod

Cursor

Add the server to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (all projects):

{ "mcpServers": { "apipod": { "url": "https://api.apipod.ai/mcp" } } }

Then open Settings → MCP, click **apipod**, and sign in. Cursor completes OAuth in the app; no client ID to paste.

Grok

At `grok.com` → Settings → Connectors → **New connector → Custom**, paste `https://api.apipod.ai/mcp` and sign in. Grok Bot accepts remote MCP servers only.

OpenClaw

openclaw mcp set apipod '{"url":"https://api.apipod.ai/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login apipod

Any MCP client

{ "mcpServers": { "apipod": { "type": "http", "url": "https://api.apipod.ai/mcp" } } }

OAuth 2.1 with PKCE; scopes `profile email`. Metadata: `https://api.apipod.ai/.well-known/oauth-authorization-server`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 40 lines
  1. {
  2. "name": "apipod-agent-plugins",
  3. "description": "APIPod plugins for AI assistants: image and video generation, cost estimates and balance through the APIPod MCP server.",
  4. "version": "0.2.4",
  5. "owner": {
  6. "name": "GeniusPath",
  7. "url": "https://www.apipod.ai"
  8. },
  9. "plugins": [
  10. {
  11. "name": "apipod",
  12. "source": "./apipod",
  13. "description": "Generate images and video inside the conversation with Nano Banana, Seedream, FLUX, GPT Image, Seedance, Kling, Gemini Omni and more, through one APIPod account. Quotes every generation before it runs; failed jobs are refunded. After installing, run /mcp and sign in to APIPod.",
  14. "version": "0.2.4",
  15. "author": {
  16. "name": "GeniusPath",
  17. "url": "https://www.apipod.ai"
  18. },
  19. "homepage": "https://www.apipod.ai",
  20. "repository": "https://github.com/geniuspath/apipod-agent-plugins",
  21. "license": "Apache-2.0",
  22. "keywords": [
  23. "ai-image-generator",
  24. "ai-video-generator",
  25. "image-generation",
  26. "video-generation",
  27. "text-to-image",
  28. "text-to-video",
  29. "image-to-video",
  30. "image-editing",
  31. "seedance",
  32. "kling",
  33. "nano-banana",
  34. "seedream",
  35. "apipod"
  36. ],
  37. "category": "creative"
  38. }
  39. ]
  40. }
README.md · README · 263 lines
  1. # APIPod for AI assistants
  2. Generate images and video inside Claude, Claude Code, ChatGPT, Codex, Cursor, Grok and OpenClaw through one APIPod account — no provider API keys.
  3. This repository is a **plugin marketplace**: it holds the manifests and skills that point an assistant at APIPod's remote MCP server. There is no runtime code here; every tool lives on the server.
  4. ## Install
  5. ### Claude Code
  6. ```bash
  7. claude plugin marketplace add geniuspath/apipod-agent-plugins
  8. claude plugin install apipod@apipod-agent-plugins
  9. ```
  10. Then run `/mcp`, select **apipod**, and sign in with the browser.
  11. ### Claude web / Desktop
  12. Add a custom connector with the URL `https://api.apipod.ai/mcp` (Customize → Connectors), sign in, and start a new chat. The skills in this repo are optional there; the server's own instructions cover the basics.
  13. ### ChatGPT
  14. Add a custom connector with the URL `https://api.apipod.ai/mcp/chatgpt` (Settings → Connectors → Advanced, developer mode), sign in, then start a chat. The `/chatgpt` surface keeps top-up links out of the conversation.
  15. ### Codex
  16. ```bash
  17. codex plugin marketplace add geniuspath/apipod-agent-plugins
  18. codex plugin add apipod@apipod-agent-plugins
  19. ```
  20. Or register the server directly:
  21. ```bash
  22. codex mcp add apipod --url https://api.apipod.ai/mcp
  23. codex mcp login apipod
  24. ```
  25. ### Cursor
  26. Add the server to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (all projects):
  27. ```json
  28. { "mcpServers": { "apipod": { "url": "https://api.apipod.ai/mcp" } } }
  29. ```
  30. Then open Settings → MCP, click **apipod**, and sign in. Cursor completes OAuth in the app; no client ID to paste.
  31. ### Grok
  32. At `grok.com` → Settings → Connectors → **New connector → Custom**, paste `https://api.apipod.ai/mcp` and sign in. Grok Bot accepts remote MCP servers only.
  33. ### OpenClaw
  34. ```bash
  35. openclaw mcp set apipod '{"url":"https://api.apipod.ai/mcp","transport":"streamable-http","auth":"oauth"}'
  36. openclaw mcp login apipod
  37. ```
  38. ### Any MCP client
  39. ```json
  40. { "mcpServers": { "apipod": { "type": "http", "url": "https://api.apipod.ai/mcp" } } }
  41. ```
  42. OAuth 2.1 with PKCE; scopes `profile email`. Metadata: `https://api.apipod.ai/.well-known/oauth-authorization-server`.
  43. ## What you get
  44. | Tool | Purpose |
  45. | --- | --- |
  46. | `list_models` | Image / video / speech models available on the account |
  47. | `get_model_params` | A model's request schema (enums, defaults) |
  48. | `estimate_cost` | Price a generation before running it; compares against balance |
  49. | `get_balance` | Remaining balance |
  50. | `generate_image` | Text-to-image and image editing → `job_id` |
  51. | `generate_video` | Text / image / reference → video → `job_id` |
  52. | `check_job` | Poll a job until `completed`; returns permanent URLs and final cost |
  53. Live catalog: `https://api.apipod.ai/mcp/catalog`. Prices: `https://www.apipod.ai/pricing.md`.
  54. ## Skills
  55. Two kinds: **focused** skills do one thing well; **workflow** skills carry the judgement that turns several generations into a usable deliverable. `apipod` routes between them.
  56. | Skill | Kind | When it activates |
  57. | --- | --- | --- |
  58. | `apipod` | router | Mixed requests, model questions, balance, "not connected" guidance |
  59. | `apipod-setup` | onboarding | First run after install: connection check, one image, one clip |
  60. | `apipod-generate-image` | focused | One image: generate or edit |
  61. | `apipod-edit-image` | focused | Change an existing image, keep the subject |
  62. | `apipod-generate-video` | focused | One clip: text / first frame / references |
  63. | `apipod-vertical-video` | focused | 9:16 clips for Reels, TikTok, Shorts |
  64. | `apipod-estimate-cost` | focused | Price questions, budgets, model comparison — never generates |
  65. | `apipod-budget` | focused | Pick the cheapest option that meets the brief; never generates |
  66. | `apipod-troubleshoot` | focused | 401, sign-in loop, stuck job, rejected parameter |
  67. | `apipod-product-shoot` | workflow | One product → a consistent set of shots (hero, detail, lifestyle, scale) |
  68. | `apipod-short-film` | workflow | Multi-shot sequence: storyboard, per-shot quotes, generate in order |
  69. | `apipod-plan-video` | workflow | Storyboard and price a video without producing it |
  70. | `apipod-ad-variations` | workflow | One approved base → a variant matrix along a single axis |
  71. | `apipod-ugc-ad` | workflow | Product → persona shot → short clip, creator format |
  72. Deliberately absent: voiceover, music, sound effects, voice cloning, characters,
  73. avatars and long-video cutting. APIPod's MCP surface is seven tools — image,
  74. video, pricing and balance — and a skill that promises a tool the server does
  75. not expose is worse than no skill. Speech models appear in `list_models`, but
  76. `generate_speech` has not shipped yet.
  77. The skills enforce one rule above all: **one request = one paid attempt**. Retries, comparisons and "fixes" that generate again need an explicit yes.
  78. ## Layout
  79. ```
  80. server.json Official MCP Registry entry (published on tag)
  81. .claude-plugin/marketplace.json Claude Code / Claude web marketplace manifest
  82. .agents/plugins/marketplace.json Codex marketplace manifest
  83. .cursor-plugin/marketplace.json Cursor + Grok Bot marketplace manifest
  84. apipod/ ← the plugin; also the OpenAI ZIP root
  85. plugin.json Portable manifest (agent-plugins.org) + OpenAI listing & review cases
  86. mcp.json MCP server entry for Cursor / Codex (general /mcp)
  87. .mcp.json MCP server entry for Claude Code
  88. .claude-plugin/plugin.json Claude plugin manifest
  89. .cursor-plugin/plugin.json Cursor / Grok Bot plugin manifest
  90. openclaw.plugin.json OpenClaw plugin manifest (server + skills)
  91. assets/logo.png Plugin icon
  92. skills/ 7 skills (see above)
  93. openai/
  94. mcp.json ChatGPT surface: /mcp/chatgpt + OAuth DCR declaration; overlaid into the ZIP
  95. plugin.openai.json Legacy Codex-format copy of the listing (kept for the compatibility path)
  96. scripts/
  97. build-openai-zip.mjs Validate against portal rules, then write dist/apipod-<version>.zip
  98. check-versions.mjs Fail if any manifest's version drifts
  99. ```
  100. Every manifest above points at the same remote server. The host decides which
  101. file it reads; nothing here runs locally.
  102. ## Publish to the OpenAI plugin directory
  103. The directory is shared by ChatGPT and Codex, and takes one ZIP:
  104. ```bash
  105. node scripts/build-openai-zip.mjs # dist/apipod-0.2.0.zip
  106. node scripts/build-openai-zip.mjs --check # validate only
  107. ```
  108. The script stages `plugin.json`, `skills/`, `assets/` from `apipod/` and
  109. `openai/mcp.json` as the ZIP's `mcp.json`, and refuses to build when a portal
  110. rule would reject the upload (listing field limits, exactly 5 positive + 3
  111. negative review cases, missing icon, hooks, a `clientSecret`, …).
  112. What the portal then needs from the server side, in order:
  113. 1. **Dynamic client registration on.** `OAUTH_PROVIDER_DYNAMIC_REGISTRATION_ENABLED=true`
  114. so `/.well-known/oauth-authorization-server` advertises `registration_endpoint`.
  115. 2. **Domain verification.** Serve the token the portal shows as plain text at
  116. `https://api.apipod.ai/.well-known/openai-apps-challenge`.
  117. 3. **Connect and scan.** Under *MCPs* → *Connect*, sign in with a reviewer
  118. account; the portal runs the 7 tools and reports findings.
  119. 4. **Demo recording.** `review.demo_recording_url` in `plugin.json` must be a
  120. reviewer-accessible walkthrough before submission.
  121. After the first approval, MCP tool changes ship with the server and are
  122. rescanned automatically; only `plugin.json` and `skills/` changes need a new ZIP.
  123. ## Versioning
  124. One version string across all eight manifests (including `server.json`);
  125. `node scripts/check-versions.mjs` fails on drift. Bump together before
  126. tagging. CI runs that check plus `claude plugin validate` for the Claude
  127. layout, the OpenAI portal checks, and `mcp-publisher validate` against the
  128. live registry schema.
  129. ## Publish to the official MCP Registry
  130. `server.json` lists APIPod at `ai.apipod/mcp` as a remote-only
  131. `streamable-http` server. There is no package to publish — the registry holds
  132. metadata only, and the server already runs at `https://api.apipod.ai/mcp`.
  133. The registry is **not** populated by pull requests. Submitting `server.json`,
  134. a server directory, or a `data/seed.json` entry does not list a server even if
  135. the PR is merged; publication happens through the `mcp-publisher` CLI writing
  136. to the registry API.
  137. Pushing a tag does it:
  138. ```bash
  139. # version in server.json and every manifest must equal the tag
  140. git tag v0.2.4 && git push origin v0.2.4
  141. ```
  142. `.github/workflows/publish-mcp.yml` then verifies the tag against
  143. `server.json`, signs in with DNS auth, and publishes. The registry rejects a
  144. duplicate `name` + `version`, so every release needs a bump.
  145. ### One-time setup
  146. 1. **Apex TXT record** on `apipod.ai` (Cloudflare). It goes on the apex, not a
  147. `_mcp-auth` selector:
  148. ```
  149. apipod.ai. IN TXT "v=MCPv1; k=ed25519; p=<public key>"
  150. ```
  151. Both values come from one key pair, kept out of the repo as `key.pem`
  152. (`.gitignore` covers it):
  153. ```bash
  154. openssl genpkey -algorithm Ed25519 -out key.pem
  155. # public key → the TXT record
  156. openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64
  157. # private key, 64 hex chars → the MCP_PRIVATE_KEY secret
  158. openssl pkey -in key.pem -noout -text \
  159. | sed -n '/priv:/,/pub:/p' | sed '1d;$d' | tr -d ' :\n'
  160. ```
  161. The secret holds that **hex string**, not the PEM file — `mcp-publisher
  162. login dns --private-key` takes hex. `/opt/homebrew/opt/openssl@3/bin/openssl`
  163. is needed for `genpkey -algorithm Ed25519` if the system `openssl` is
  164. LibreSSL.
  165. 2. **`MCP_PRIVATE_KEY` repository secret** — the hex string above. If the key
  166. is rotated, remove the old TXT record before adding the new one; a stale
  167. record is tried first and fails verification.
  168. Local checks before tagging (no credentials needed):
  169. ```bash
  170. brew install mcp-publisher
  171. mcp-publisher validate
  172. ```
  173. Verify the listing — `search` is a substring match on the name, so the full
  174. `namespace/name` never matches it. Use the path form, URL-encoding the slash:
  175. ```bash
  176. curl "https://registry.modelcontextprotocol.io/v0.1/servers/ai.apipod%2Fmcp/versions/latest"
  177. ```
  178. Before the first publish this returns `404`; afterwards it returns the record
  179. with `"name":"ai.apipod/mcp"`. To list every published version, drop
  180. `/versions/latest`.
  181. Superseded names stay in the registry and are hidden from default listings by
  182. setting their status to `deleted`:
  183. ```bash
  184. mcp-publisher status --status deleted --message "Renamed to ai.apipod/mcp" \
  185. ai.apipod/apipod 0.2.2
  186. ```
  187. `deprecated` is **not** the right status for a rename: it leaves the record in
  188. `version=latest` and keeps its `isLatest` flag, so both entries show up side by
  189. side.
  190. ## Pricing
  191. Pay as you go in USD from the APIPod balance; no subscription. A generation that fails with a server error is refunded automatically. `https://www.apipod.ai/pricing`
  192. ## License
  193. Apache-2.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.