MCP - Typecast Documentation

Hosted endpoint and authentication

https://typecast.ai/docs/mcp is one hosted endpoint for documentation search and API tools. Without an API key, it provides documentation search through search_documentation. Authenticate with a Typecast API key to use voice lookup, recommendations, and speech generation at the same address. You do not need to install a separate server to use these API tools.

First check whether your MCP client supports remote Streamable HTTP connections and the authentication method you intend to use. For clients that support custom headers, see the hosted-server API key example below. Protocol support alone does not establish a particular client connection or authentication procedure. Do not enter API keys in chat.

One-Click Install

For Cursor and Replit, just click the button below:

Add to Cursor

One-click install for Cursor IDE

Add to Replit

One-click install for Replit

Other MCP Clients

For other MCP-compatible clients, add this URL:

https://typecast.ai/docs/mcp

Claude Code

claude mcp add --transport http typecast-helper https://typecast.ai/docs/mcp

Windsurf

Open Windsurf Settings
Navigate to Cascade → MCP Servers
Click "Add Server" → "Add Remote MCP Server"
Enter URL: https://typecast.ai/docs/mcp

VS Code (Copilot)

Add to your .vscode/mcp.json:

{
  "servers": {
    "typecast-helper": {
      "url": "https://typecast.ai/docs/mcp"
    }
  }
}

That's it! You can now ask your AI assistant to help you integrate Typecast TTS into your projects.

What You Can Do

Once connected, your AI assistant gains knowledge about:

API Integration - Get code examples for any language
Voice Selection - Find the perfect voice for your use case
Best Practices - Learn optimal settings for different scenarios
Troubleshooting - Quick solutions for common issues

"Integrate Typecast TTS into my project."

Advanced: Automated TTS Generation

Set model explicitly. On a server release supporting SSFM 3.1, select ssfm-v31 and use the same model filter in get_voices to find compatible voices and supported emotions. SSFM 3.1 requires an SDK or integration release that accepts ssfm-v31. Check the installed version and model options; if unavailable, use v21/v30 with these examples or the REST API for v31; see the TTS API reference for v31 requests and voice discovery.

Need to generate audio files automatically? The hosted or self-hosted Typecast API MCP server lets your AI assistant directly call the Typecast API to create audio on demand, perfect for batch processing and automated workflows.

Both options also provide recommend_voices for natural-language voice search. Recommendation results contain only voice_id, voice_name, and score, so call get_voice or get_voices when your workflow needs metadata such as supported models, emotions, gender, age, or use cases.

What Makes This Different

Hosted endpoint without an API key	Same hosted endpoint with an API key	Self-hosted API MCP
Provides knowledge and guidance	Calls Typecast API directly	Calls Typecast API directly
No API key required	No local installation	Runs on your computer
Best for integration help	Best for quick automation	Best for local files and audio playback

Prerequisites

Typecast API key (Get yours here)
uv package manager (self-hosted only)

Setup

Add the hosted Streamable HTTP endpoint to an MCP client that supports custom headers:

{
  "mcpServers": {
    "typecast": {
      "url": "https://typecast.ai/docs/mcp",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

Without the API key, the hosted server exposes only search_documentation. Authenticated requests unlock the Typecast API tools. Generated audio is returned as a private download URL that expires after one hour.