{
  "markdown": "# MCP Fish Server\n\n<!-- mcp-name: io.github.AceDataCloud/mcp-fish -->\n\nA Model Context Protocol (MCP) server for Fish Audio TTS (Text-to-Speech) via the AceDataCloud platform.\nGenerate natural-sounding speech and explore the Fish voice model library.\n\n## Features\n\n- **High-quality TTS**: Generate speech from text via Fish Audio models\n- **Voice library**: Browse, search, and fetch metadata for Fish voice models\n- **Asynchronous tasks**: Submit generation tasks and poll for results\n- **Batch task lookup**: Query multiple task results in one call\n\n### One-shot voice cloning\n\nPass 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:\n\n```python\nfish_generate_audio(\n    text=\"New speech in the referenced voice\",\n    reference_audio_url=\"https://cdn.acedata.cloud/reference.mp3\",\n    reference_text=\"The exact words spoken in the reference audio\",\n)\n```\n\nUse `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.\n\n## Installation\n\n```bash\npip install mcp-fish\n```\n\n## Configuration\n\nSet your AceDataCloud API token:\n\n```bash\nexport ACEDATACLOUD_API_TOKEN=your_token_here\n```\n\nGet your token from [https://platform.acedata.cloud](https://platform.acedata.cloud).\n\n## Usage\n\n### stdio mode (default)\n\n```bash\nmcp-fish\n```\n\n### HTTP mode\n\n```bash\nmcp-fish --transport http --port 8000\n```\n\n## Tool Reference\n\n| Tool | Description |\n|------|-------------|\n| `fish_generate_audio` | Generate speech from text via a Fish voice model |\n| `fish_list_models` | List available Fish voice models |\n| `fish_get_model` | Fetch metadata for a specific Fish voice model |\n| `fish_get_task` | Get the status / result of a generation task |\n| `fish_get_tasks_batch` | Batch-fetch the status / result of multiple tasks |\n| `fish_get_usage_guide` | Get the API usage guide |\n\n## Documentation\n\n<!-- canonical-documentation -->\n[Documentation](https://platform.acedata.cloud/documents/fish)\n\n## License\n\nMIT — see [LICENSE](../LICENSE) at the repository root.\n",
  "bytes": 2235,
  "sha": "29cdb8615e9c90a7849468ea0cfbfe569b0c402c5c1bb6a28c79e4d889c92428",
  "repo_slug": "acedatacloud/fishmcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_acedatacloud_mcp_fish_ba377486/readme"
}