# MCP Fish

> MCP Fish is an MCP server for design and media. Text-to-speech with voice conditioning through the Fish Audio API, for AI clients. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://platform.acedata.cloud/documents/fish
- **Repository:** https://github.com/acedatacloud/fishmcp
- **MCP Registry name:** io.github.AceDataCloud/mcp-fish
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-fish https://fish.mcp.acedata.cloud/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://fish.mcp.acedata.cloud/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-fish": {
      "url": "https://fish.mcp.acedata.cloud/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-fish": {
      "type": "http",
      "url": "https://fish.mcp.acedata.cloud/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-fish": {
      "serverUrl": "https://fish.mcp.acedata.cloud/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-fish": {
      "type": "http",
      "url": "https://fish.mcp.acedata.cloud/mcp"
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Voxtral TTS MCP](https://ai-powered.com/mcp/voxtral-tts-mcp): Voxtral TTS MCP is an open-source MCP server for design and media.
- [Texttospeech Mcp](https://ai-powered.com/mcp/texttospeech-mcp): Texttospeech Mcp is a freemium MCP server for ai models and llm tooling.
- [MCP Flux Pro](https://ai-powered.com/mcp/mcp-flux-pro): MCP Flux Pro is an open-source MCP server for design and media.
- [Agent Data Tools: Speech to text and text to speech](https://ai-powered.com/mcp/agent-data-tools-speech-to-text-and-text-to-speech): Agent Data Tools: Speech to text and text to speech is a paid MCP server for design and media.
- [MCP Aichat](https://ai-powered.com/mcp/mcp-aichat): MCP Aichat is an MCP server for ai models and llm tooling.
- [Speechtotext Mcp](https://ai-powered.com/mcp/speechtotext-mcp): Speechtotext Mcp is a freemium MCP server for ai models and llm tooling.
- [ACE Music by Ace Data Cloud](https://ai-powered.com/mcp/ace-music-by-ace-data-cloud): ACE Music by Ace Data Cloud is a paid MCP server for design and media.
- [Cartesia](https://ai-powered.com/mcp/cartesia): Cartesia is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/mcp-fish
