Skip to main content

​
Overview

Integrate Fish Audio’s comprehensive documentation directly into your AI coding assistants. Using MCP (Model Context Protocol), coding agents like Claude Code, Cursor, and Windsurf can access our latest API references, guides, and examples in real-time.
The Fish Audio MCP server provides instant access to:
  • Complete API documentation
  • SDK usage examples
  • Best practices and implementation patterns
  • Troubleshooting guides
Connect once and get accurate, up-to-date Fish Audio knowledge in your coding environment.

​
Why Use MCP Integration?

Real-Time Docs

Access the latest API documentation without leaving your editor

Accurate Code

Generate working code based on current API specifications

Smart Assistance

Get context-aware help for debugging and optimization

​
Setup

  • Claude Code
  • Cursor
  • Windsurf
1

Run Installation Command

Open your terminal and run:
claude mcp add --transport http fish-audio https://docs.fish.audio/mcp
This adds the Fish Audio documentation server to your Claude Code configuration.
2

Verify Connection

Check that the server is connected:
claude mcp list
You should see fish-audio in the list of configured servers.
3

Test Integration

Ask Claude Code: “What Fish Audio models are available?” or “How do I use Fish Audio’s TTS API?”

​
Using the Integration

​
Example Queries

Once connected, ask your coding agent questions naturally:

Authentication

“How do I authenticate with Fish Audio API?”

TTS Example

“Show me Python code for text-to-speech”

Emotions

“What emotion parameters are available?”

WebSocket

“Help me implement real-time streaming”

​
Code Generation Examples

  • Basic TTS
  • Voice Cloning
  • Streaming
Ask: “Generate a Python function for text-to-speech with Fish Audio”
from fish_audio import FishAudioClient

def text_to_speech(text: str, voice_id: str, output_file: str):
    """Convert text to speech using Fish Audio API"""
    client = FishAudioClient(api_key="your-api-key")

    response = client.tts.create(
        text=text,
        model_id=voice_id,
        format="mp3"
    )

    with open(output_file, "wb") as f:
        f.write(response.audio_data)

    return output_file

​
Available Documentation

Your coding agent can access:

API Reference

Complete endpoint documentation with parameters

SDK Guides

Python SDK usage and examples

Best Practices

Optimization patterns and tips

Models & Pricing

Available models and rate limits

Voice Cloning

Custom voice creation guides

Troubleshooting

Common issues and solutions

​
Advanced Usage

​
Custom Commands

Create agent workflows for common tasks: 
"Create a complete voice generation pipeline with:
- Authentication
- Voice selection
- Emotion control
- Error handling
- Audio export"

​
Context-Aware Features

With MCP integration, your agent can:
  • Suggest appropriate models based on use case
  • Handle rate limiting automatically
  • Provide inline documentation
  • Validate API calls against specifications
  • Recommend optimization strategies

​
Troubleshooting

If the MCP server isn’t connecting:
  1. Verify internet connectivity
  2. Check https://docs.fish.audio/mcp is accessible
  3. Ensure your agent supports MCP protocol
  4. Restart your coding environment
  5. Clear any cached configurations
The MCP server always serves the latest documentation:
  1. Refresh the MCP connection in settings
  2. Clear documentation cache if available
  3. Report persistent issues to support@fish.audio
If certain features aren’t available:
  1. Verify you’re using the latest agent version
  2. Check MCP protocol compatibility
  3. Ensure proper server configuration
  4. Contact support for assistance

​
Security

Your data is safe:
  • MCP provides read-only access to public documentation
  • No API keys are transmitted through MCP
  • All connections use HTTPS encryption
  • No user queries or usage data is stored

​
Next Steps

API Introduction

Start with Fish Audio API basics

Python SDK

Install and configure the Python SDK

TTS Best Practices

Learn text-to-speech optimization

Voice Cloning Guide

Create custom voice models

​
Support

Need help with MCP integration?