MCP

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

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. The self-hosted server also provides 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

URL-based MCP	Self-hosted MCP Server
Provides knowledge & guidance	Actually generates audio files
No API calls made	Calls Typecast API directly
Great for learning & integration help	Great for automation & batch work

Prerequisites

uv package manager
Typecast API key (Get yours here)

Setup

Claude Desktop (macOS)
Claude Desktop (Windows)
Claude Desktop (Linux)
Cursor
Claude Code

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

Edit %APPDATA%\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": "C:\\Users\\yourname\\Downloads\\typecast_output"
      }
    }
  }
}

Edit ~/.config/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": "/home/yourname/Downloads/typecast_output",
        "XDG_RUNTIME_DIR": "/run/user/1000"
      }
    }
  }
}

Linux requires XDG_RUNTIME_DIR for audio playback.

Add to your MCP settings in Cursor:

{
  "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": "/path/to/output"
      }
    }
  }
}

# Add the Typecast MCP server
claude mcp add typecast \
  --command "uvx --from git+https://github.com/neosapience/typecast-api-mcp-server.git typecast-api-mcp-server" \
  --env TYPECAST_API_KEY=YOUR_API_KEY \
  --env TYPECAST_OUTPUT_DIR=/path/to/output

Troubleshooting

MCP server not appearing

Verify the configuration is correct
Restart your application completely
Check that uv is installed and available in your PATH

API key errors

Confirm your API key is set correctly in the config
Verify your key at Typecast API

Audio not playing (Linux)

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

GET STARTED

SDKs

INTEGRATIONS

One-Click Install

Add to Cursor

Add to Replit

Other MCP Clients

What You Can Do

Advanced: Automated TTS Generation

What Makes This Different

Prerequisites

Setup

Troubleshooting

Resources

GitHub Repository

API Reference

Voice Library

Python SDK

​One-Click Install

Add to Cursor

Add to Replit

​Other MCP Clients

​What You Can Do

​Advanced: Automated TTS Generation

​What Makes This Different

​Prerequisites

​Setup

​Troubleshooting

​Resources

GitHub Repository

API Reference

Voice Library

Python SDK

One-Click Install

Other MCP Clients

What You Can Do

Advanced: Automated TTS Generation

What Makes This Different

Prerequisites

Setup

Troubleshooting

Resources