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
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.
Metadata
Release files for mcp-fish 2026.9.1.0
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.1.0.tar.gz | 25.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_fish-2026.9.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 50.3 kB
Release files / mcp_fish-2026.9.1.0.tar.gz
| Download URL | mcp_fish-2026.9.1.0.tar.gz |
|---|---|
| Size | 25.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
af292d0b156a075900fd59f7579cb0612b8a029280c4255b2ec62edbbba7e0c8
|
|
BLAKE2b-256 checksum How to use checksums |
95b4fcbea540da2153223e08be2bb9c31affbac950250c98fbb6558459be2b98
|
| 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.1.0-py3-none-any.whl
| Download URL | mcp_fish-2026.9.1.0-py3-none-any.whl |
|---|---|
| Size | 25.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d417f4ef59748f9151c85182af4be79d3515add44c8ec53d2cb711fab65a9c70
|
|
BLAKE2b-256 checksum How to use checksums |
34023d5253abba17ee77af318376d1c2d6d50e00f7e8f17a1af359edf42e2cd8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.3
|