Labsco
MCP SERVER

Typecast API

by neosapience

Pick a Typecast voice, synthesise speech, and clone a temporary custom voice from a short audio sample.

Speech Synthesis & TranscriptionVerified
Summary
Typecast's voice catalogue and synthesis endpoints, with voice recommendation doing the hard part.

The tool that changes how an agent works here is recommend_voices: you describe a style and get ranked voice IDs, instead of needing one in hand before you can start. Cloning is deliberately short-lived — the sample must be WAV or MP3 under 25 MB, and you delete the voice when the job is done.

What it is

An MCP server for the Typecast text-to-speech API. It exposes the voice catalogue, the synthesis endpoints and quick voice cloning as tools, so an assistant can choose a voice and produce audio without you writing API calls.

What you get
  • get_voices and get_voice — browse the V2 catalogue filtered by model or gender, or read one voice by ID
  • recommend_voices — describe the style, mood or language you want in plain text and get candidate voice IDs back with scores
  • text_to_speech — synthesise a line with a chosen voice and model
  • text_to_speech_stream — synthesise through the streaming endpoint and save the concatenated audio
  • text_to_speech_with_timestamps — synthesise and return timestamp alignment for caption generation
  • clone_voice and delete_cloned_voice — build a temporary voice from a WAV or MP3 sample, then remove it; cloned IDs start with uc_
  • play_audio — play a generated file on the machine running the server
  • get_my_subscription — read the plan tier, credits used and total, and the concurrency limit
  • search_documentation — search the Typecast documentation
Requirements

A Typecast API key. Locally, clients launch it with uvx from the repository and read TYPECAST_API_KEY plus TYPECAST_OUTPUT_DIR (default ~/Downloads/typecast_output); it needs Python 3.10 or newer, and XDG_RUNTIME_DIR on Linux. A hosted Streamable HTTP endpoint takes the key in an X-API-KEY header — without one it exposes only search_documentation, and play_audio stays local-only.

Setup effort

One command plus a key — uvx --from git+https://github.com/neosapience/typecast-api-mcp-server.git typecast-api-mcp-server, then supply credentials