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.

Metadata

Release files for mcp-fish 2026.10.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-fish 2026.10.4.1
File	Size	Uploaded
mcp_fish-2026.10.4.1.tar.gz	27.9 kB	Oct 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-fish 2026.10.4.1
File	Interpreter	ABI	Platform	Reset
mcp_fish-2026.10.4.1-py3-none-any.whl 26.2 kB Oct 4, 2026	Python 3	none	any	Details

Total release size: 54.2 kB

Release files / mcp_fish-2026.10.4.1.tar.gz

Download URL	mcp_fish-2026.10.4.1.tar.gz
Size	27.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`ec4693c60530bd22bca635f80edd282e303dc121cd4f68838ca396b72937316f`
BLAKE2b-256 checksum How to use checksums	`4abce30998ea85025dc63f629069ea9f4781dcf05ddfefc5fe611eee923459bd`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.3`

Release files / mcp_fish-2026.10.4.1-py3-none-any.whl

Download URL	mcp_fish-2026.10.4.1-py3-none-any.whl
Size	26.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`db4fc7e72d5819ea73c476edd81a505cba2c36e710cb3aeee6a8d857422f2e69`
BLAKE2b-256 checksum How to use checksums	`bf95373582e65e9d70375037e5b94252ae607376676ff8a6b6ea0318caf44ad1`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.3`