Skip to main content

Documentation Index

Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Connect this Model Context Protocol to give your AI complete Typecast knowledge, integrate Typecast TTS into your service in minutes.

​
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 mcp add typecast-helper https://typecast.ai/docs/mcp
  1. Open Windsurf Settings
  2. Navigate to Cascade → MCP Servers
  3. Click “Add Server” → “Add Remote MCP Server”
  4. Enter URL: https://typecast.ai/docs/mcp
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."
The setup above is all you need. The section below is optional for advanced use cases.

​
Advanced: Automated TTS Generation

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

​
What Makes This Different

URL-based MCPSelf-hosted MCP Server
Provides knowledge & guidanceActually generates audio files
No API calls madeCalls Typecast API directly
Great for learning & integration helpGreat for automation & batch work

​
Prerequisites

​
Setup

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "typecast": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/neosapience/typecast-api-mcp-server.git",
        "typecast-api-mcp-server"
      ],
      "env": {
        "TYPECAST_API_KEY": "YOUR_API_KEY",
        "TYPECAST_OUTPUT_DIR": "/Users/yourname/Downloads/typecast_output"
      }
    }
  }
}

​
Troubleshooting

  • Verify the configuration is correct
  • Restart your application completely
  • Check that uv is installed and available in your PATH
  • Confirm your API key is set correctly in the config
  • Verify your key at Typecast API
  • Set XDG_RUNTIME_DIR environment variable
  • Check audio device: aplay -l

​
Resources

GitHub Repository

View source code for Self-hosted MCP Server

API Reference

Explore the Typecast API

Voice Library

Browse available voices

Python SDK

Build custom integrations