AudioPod agent plugin
One installable package that gives any plugin-capable coding agent AudioPod's audio AI β ten MCP tools over a single hosted endpoint, plus fourteen task skills that describe the full multi-step flows (narrate an audiobook, build a podcast, cut a karaoke track).
No install, no local models, no GPU.
| MCP endpoint | https://mcp.audiopod.ai |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Auth | X-API-Key: ap_* (or OAuth2 / JWT) β get a free key |
| Docs | https://docs.audiopod.ai/sdks/mcp |
| Pricing | https://www.audiopod.ai/developers/pricing |
| Registry | ai.audiopod/audiopod on the official MCP Registry |
| Server repo | AudiopodAI/audiopod-mcp β the standalone MCP listing (server.json + server card) |
Your first API key comes with $1 of free API credit.
Set your key first
Every client below reads the key from the AUDIOPOD_API_KEY environment
variable β except Gemini CLI, which prompts for it and stores it in your system
keychain. No key is ever written into this repo.
export AUDIOPOD_API_KEY=ap_your_key_here
Install
Claude Code
claude plugin marketplace add AudiopodAI/audiopod-plugins
claude plugin install audiopod@audiopod
Then /audiopod in a session to see what is available and check the
connection. The owner/repo shorthand falls back to HTTPS when no GitHub SSH
key is configured; claude plugin marketplace add https://github.com/AudiopodAI/audiopod-plugins
is the explicit equivalent.
Gemini CLI
gemini extensions install https://github.com/AudiopodAI/audiopod-plugins
Gemini reads gemini-extension.json, prompts for the AudioPod API key on
install and stores it as a sensitive setting.
Codex
codex plugin marketplace add AudiopodAI/audiopod-plugins
codex plugin add audiopod@audiopod
Codex reads the same marketplace manifest this repo ships for Claude Code, then
loads plugin.json, mcp.json and skills/ from the plugin root. /plugins
inside Codex CLI browses configured and remote marketplaces instead.
Cursor
Customize β Plugins β search for AudioPod β Install, and pick project
or user scope. To test before it is listed, clone the repo into
~/.cursor/plugins/local:
git clone https://github.com/AudiopodAI/audiopod-plugins.git ~/.cursor/plugins/local/audiopod
Kiro
Powers panel β Add Custom Power β Import power from GitHub, enter
https://github.com/AudiopodAI/audiopod-plugins, then Install.
Any other MCP client
Skip the plugin layer and point your client straight at the server:
{
"mcpServers": {
"audiopod": {
"type": "streamable-http",
"url": "https://mcp.audiopod.ai",
"headers": { "X-API-Key": "ap_YOUR_KEY" }
}
}
}
Tools
| Tool | Does |
|---|---|
text_to_speech | Speech in 200+ languages, 500+ voices and custom clones |
clone_voice | Clone a voice from a 5β30s reference clip |
change_voice | Convert a recording to a different target voice |
generate_music | Songs, instrumentals, rap, or vocal stems from a text prompt |
separate_stems | Split a track into stems (vocals, drums, bass, β¦); two-stem mode = karaoke |
separate_speakers | Isolate each speaker into a separate track |
transcribe_audio | Transcribe with word-level timestamps and speaker diarization |
denoise_audio | Remove background noise while preserving voice character |
convert_media | Convert audio/video formats (mp3/wav/flac/ogg/m4a, mp4/mov) |
check_job_status | Poll the status/result of a long-running job (free) |
Long-running tools return a job_id immediately β poll check_job_status
until COMPLETED. Polling is free.
Skills
Fourteen skills ship in skills/, each a SKILL.md the agent loads on demand.
They cover the tasks that need more than one call, and document the REST
endpoints for the ones that are not exposed as MCP tools.
| Skill | For |
|---|---|
text-to-speech | Voiceover and narration, with inline directing and word timestamps |
design-voice | Build a brand-new voice from a text description |
clone-voice | Clone a voice from a reference recording |
change-voice | Re-voice an existing recording |
narrate-audiobook | Manuscript β ACX-spec audiobook with chapters and retail sample |
create-podcast | Script or source material β multi-voice podcast episode |
read-article | Article or URL β listenable audio |
generate-music | Songs, instrumentals and stems from a prompt |
separate-stems | Stems and karaoke tracks |
separate-speakers | One track per speaker |
transcribe-audio | Transcripts with timestamps and diarization |
translate-audio | Translate and re-voice into another language |
denoise-audio | Clean up noisy recordings |
convert-media | Format and container conversion |
What is in this repo
| Path | Read by |
|---|---|
plugin.json, mcp.json | Agent Plugins layout β Codex, Cursor, Kiro |
.claude-plugin/plugin.json, .claude-plugin/marketplace.json | Claude Code |
.cursor-plugin/plugin.json | Cursor |
gemini-extension.json, GEMINI.md | Gemini CLI |
skills/<name>/SKILL.md | all of the above |
commands/audiopod.md | Claude Code β the /audiopod slash command |
The manifests are deliberately duplicated rather than merged: the formats agree
on skills/ and on the shape of an MCP server entry, but disagree on where the
manifest lives and on the key that carries the endpoint URL
(url vs httpUrl).
Building a startup on this?
Apply to AudioPod for Startups β free Pro for 3 months plus developer API credits for eligible early-stage teams.
License
MIT β see LICENSE. (Covers this plugin package; the AudioPod service itself is governed by the AudioPod Terms.)