MCP - Typecast Documentation

One-Click Install

For Cursor and Replit, just click the button below:

One-click install for Cursor IDE

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

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

Docs MCP	Hosted API MCP	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-api-docs-web-production.up.railway.app/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.