MCP server exposing the AceDataCloud Fish Audio API (text-to-speech with voice conditioning)
A Model Context Protocol (MCP) server for Fish Audio TTS (Text-to-Speech) via the AceDataCloud platform. Generate natural-sounding speech and explore the Fish voice model library.
Pass one public HTTPS reference audio URL plus its exact transcript. This conditions only the current TTS request and does not create a reusable voice model:
fish_generate_audio(
text="New speech in the referenced voice",
reference_audio_url="https://cdn.acedata.cloud/reference.mp3",
reference_text="The exact words spoken in the reference audio",
)
Use reference_id for saved or public voices, and the one-shot reference fields for a temporary voice. Do not combine them. Reference audio supports MP3/WAV and should be 10–270 seconds. Billing remains based on the target text's UTF-8 byte count.
pip install mcp-fish
Set your AceDataCloud API token:
export ACEDATACLOUD_API_TOKEN=your_token_here
Get your token from https://platform.acedata.cloud.
mcp-fish
mcp-fish --transport http --port 8000
| Tool | Description |
|---|---|
fish_generate_audio | Generate speech from text via a Fish voice model |
fish_list_models | List available Fish voice models |
fish_get_model | Fetch metadata for a specific Fish voice model |
fish_get_task | Get the status / result of a generation task |
fish_get_tasks_batch | Batch-fetch the status / result of multiple tasks |
fish_get_usage_guide | Get the API usage guide |
MIT — see LICENSE at the repository root.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
uvx mcp-fishMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-acedatacloud-mcp-fish": {
"command": "uvx",
"args": [
"mcp-fish"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencemcp-fishpypiio.github.AceDataCloud/mcp-fish works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.