MCP Fish Server
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.
Features
- High-quality TTS: Generate speech from text via Fish Audio models
- Voice library: Browse, search, and fetch metadata for Fish voice models
- Asynchronous tasks: Submit generation tasks and poll for results
- Batch task lookup: Query multiple task results in one call
One-shot voice cloning
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.
Installation
pip install mcp-fish
Configuration
Set your AceDataCloud API token:
export ACEDATACLOUD_API_TOKEN=your_token_here
Get your token from https://platform.acedata.cloud.
Usage
stdio mode (default)
mcp-fish
HTTP mode
mcp-fish --transport http --port 8000
Tool Reference
| 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 |
Documentation
License
MIT — see LICENSE at the repository root.
1 maintainer
Metadata
1 maintainer
Release files for mcp-fish 2026.9.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_fish-2026.9.6.1.tar.gz | 26.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_fish-2026.9.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 52.8 kB
Release files / mcp_fish-2026.9.6.1.tar.gz
| Download URL | mcp_fish-2026.9.6.1.tar.gz |
|---|---|
| Size | 26.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f947d95b5b5044338e6cae65b3fd2163f865a7093d5f8807d074ab494c0d4026
|
|
BLAKE2b-256 checksum How to use checksums |
5d462484745d315dce0e8a8a520e86b44837d56d30d622d26bbe980d95a74c92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.3
|
Release files / mcp_fish-2026.9.6.1-py3-none-any.whl
| Download URL | mcp_fish-2026.9.6.1-py3-none-any.whl |
|---|---|
| Size | 26.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
493e00869d5c5bc062071a6540d5000d13b5b18140a6e96edfaba7d0e0cada83
|
|
BLAKE2b-256 checksum How to use checksums |
0e6edcd5a3bdb2280fe5fccde7ad5ad7814b9fdb5b3da3d65fffad4de0daf909
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.3
|
