Skip to main content
The Fish Audio MCP server gives AI agents direct access to your Fish Audio account: they can browse the voice library, clone a voice, generate speech, transcribe audio, generate or edit images and videos, and produce multi-speaker Story Studio projects for you.
  • Endpoint: https://api.fish.audio/mcp (streamable HTTP)
  • Authentication: OAuth. Your MCP client opens a browser window, you sign in with your Fish Audio account, and choose the team the connection works in.
  • Billing: usage is billed the same way as the web app, not through the developer API. See Credits for what each tool costs.

​
Connect

Run /mcp inside Claude Code to sign in, then ask “Generate a short greeting with a warm English voice.”

​
Try it

Once connected, ask in plain language and the agent picks the right tools. Click a card to copy its prompt; the copied text also names the server, so the agent can help you connect it if you have not yet.
In coding agents like Claude Code and Codex, tools compose with the shell: the agent can download generated audio, images, and videos with curl, upload local recordings for transcription or reference images for editing, or batch-generate a directory of scripts.

​
Tools

The tools reference lists what each tool does, by area:

MCP tools reference

The tools the server exposes, with the exact tool names and what each one does.

​
Credits

In UTF-8, English letters, digits, and basic punctuation are one byte each, and most Chinese, Japanese, and Korean characters are three. Voice search and cloning, uploads, Story Studio import and editing, estimates and quotes, and the asset library are free. Speech and Story Studio audio in another team’s professional voice clone cost double, and failed generations are refunded.

​
Good to know

  • Add audio tags in square brackets inside the text to control delivery, such as [whispering], [excited], or [laughing].
  • If no voice is specified, a curated default voice for the requested language is used.
  • Local files for transcription or cloning go to temporary storage that is deleted after 7 days, while files you upload as inputs for image or video generation are kept in your workspace.
  • The agent asks you to approve an image or video estimate before it generates; if the credit price changes before it submits, nothing is charged and the agent asks you again.
  • Every account sees the same tools, and plan requirements are checked when a tool runs.
  • Video (including lip sync and talking avatars) needs a Plus plan or higher, and Story Studio export needs a paid plan.
  • Free plans limit how many images you can generate, and your plan sets how many private or unlisted voices you can keep.
  • The estimate or quote tells you when a request is over your plan, before anything is charged.
  • New voice clones are unlisted by default, so anyone with the voice ID can use them; ask for a private voice to keep one to your workspace.
  • Generated audio, images, and videos are returned as permanent links that anyone with the link can open.
  • A connection is bound to the team you chose at sign-in; to work in another team, add the server again and choose that team.
  • Voice, speech, transcription, and Story Studio tools use your team’s default workspace, while image, video, and asset library tools use the workspace you choose (list_my_workspaces lists them).
  • Tools can change between releases; reconnect your client to refresh its tool list.