MCP Fish
Text-to-speech with voice conditioning through the Fish Audio API, for AI clients
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 2026.11.15.0
- Listing updated
- 4 days ago
Similar MCP servers
About MCP Fish
MCP Fish is an MCP server for design and media. It can run locally on your machine or as a hosted remote server.
This server wraps the Fish Audio text-to-speech service as offered by AceDataCloud. Besides plain speech generation it can browse the Fish voice library and look up the results of asynchronous generation tasks, including several at once.
A one-shot cloning mode takes a public HTTPS reference audio URL (MP3 or WAV, 10 to 270 seconds) with its exact transcript and conditions only that request; it does not create a reusable voice. Saved voices are chosen by reference_id, and the README warns that voices saved through AceDataCloud are public and searchable by others.
You can connect to the hosted endpoint with OAuth or an API token, or run the PyPI package locally over stdio with ACEDATACLOUD_API_TOKEN. An AceDataCloud account is needed, and billing is based on the UTF-8 byte count of the target text.
Install
Run in a terminal
claude mcp add --transport http mcp-fish https://fish.mcp.acedata.cloud/mcpAdd to Settings → Connectors → Add custom connector
https://fish.mcp.acedata.cloud/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-fish": {
"url": "https://fish.mcp.acedata.cloud/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-fish": {
"type": "http",
"url": "https://fish.mcp.acedata.cloud/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-fish": {
"serverUrl": "https://fish.mcp.acedata.cloud/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://fish.mcp.acedata.cloud/mcpEnter a Name (for example "MCP Fish"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-fish": {
"type": "http",
"url": "https://fish.mcp.acedata.cloud/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ACEDATACLOUD_API_TOKENAPI token from Ace Data Cloud (https://platform.acedata.cloud)Required
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- fish_generate_audio
- Generates speech from text, optionally with a reference voice.
- fish_list_models
- Lists and searches Fish voice models, including the account's own.
What it does
- Text-to-speech
- Generates speech from text with Fish Audio models.
- One-shot voice cloning
- Conditions a single request on a reference audio URL and its transcript.
- Voice library search
- Lists and searches voice models, with paging and sorting.
- Own saved voices
- A `self=true` filter lists voices created by the calling account.
- Async task lookup
- Submits generation tasks and polls results, singly or in batch.
- Three connection routes
- Hosted OAuth, hosted API token, or local stdio.
Good for
- Narrate scripts or articles from an assistant
- Try different Fish voices and pick one by ID
- Generate speech in a temporary voice from a short sample
- Check on queued audio jobs in bulk
Pricing
Pricing unknown
Requires an AceDataCloud account and API token; billed by text byte count, prices not published here
Prices change. Check platform.acedata.cloud before you buy.
MCP Fish FAQ
Does one-shot cloning create a reusable voice?
No. It only conditions the current request. Use `reference_id` for saved or public voices, and do not combine the two.
Are saved voices private?
No. The README says saved voices are public and can be searched and used by others; `self=true` is only a list filter.
What reference audio is accepted?
MP3 or WAV, 10 to 270 seconds, supplied as a public HTTPS URL with its exact transcript.
How is usage billed?
Billing follows the UTF-8 byte count of the target text, on a metered AceDataCloud account.
How do I add MCP Fish to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp-fish https://fish.mcp.acedata.cloud/mcp
What are the best alternatives to MCP Fish?
The closest alternatives to MCP Fish are Voxtral TTS MCP, Texttospeech Mcp, MCP Flux Pro, Agent Data Tools: Speech to text and text to speech and MCP Aichat.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.
