Skip to content
MCP server

MCP Fish

Text-to-speech with voice conditioning through the Fish Audio API, for AI clients

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://fish.mcp.acedata.cloud/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-fish": {
      "url": "https://fish.mcp.acedata.cloud/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/mcp

Enter 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.

How AIPoweredBot checks servers