Typecast Api MCP Server Sample

@neosapience

Repository

Basic information

About Typecast Api MCP Server Sample

MCP Server for typecast-api

#typecast-api#mcp-server #api-integration

Typecast Api MCP Server Sample config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "typecast-api-mcp-server-sample": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Typecast Api MCP Server Sample tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is typecast-api-mcp-server-sample?

It is an MCP (Model Context Protocol) server for the Typecast API, enabling MCP clients like Claude Desktop or Cursor to interact with Typecast’s text-to-speech and voice management features in a standardized way.

How to use typecast-api-mcp-server-sample?

Configure it in your MCP client’s claude_desktop_config.json or Cursor MCP settings with the command uvx and set environment variables TYPECAST_API_KEY and TYPECAST_OUTPUT_DIR. Alternatively, clone the repository and run locally with Python 3.10+ and uv.

Key features of typecast-api-mcp-server-sample

Voice management: list, get, and recommend voices.
Text-to-speech with standard, streaming, and timestamped output.
Supports ssfm-v30 model with 7 emotion presets and Smart Mode.
Quick Voice Cloning from local WAV/MP3 files (≤25 MB).
Audio playback and loudness normalization via target_lufs.
Tools available: clone_voice, delete_cloned_voice, text_to_speech, text_to_speech_stream, text_to_speech_with_timestamps.

Use cases of typecast-api-mcp-server-sample

Generate speech from text using different voices and emotional tones.
Create temporary custom voices by cloning audio samples for a single session.
Retrieve voice recommendations based on desired style, mood, language, or use case.
Integrate Typecast TTS into AI assistant workflows via MCP clients.

Frequently asked questions

What emotions are supported?

ssfm-v30 offers 7 presets: normal, happy, sad, angry, whisper, toneup, and tonedown, plus a Smart Mode that infers emotion from context using `previous_text` and `next_text`. ssfm-v21 supports preset only.

What are the constraints for Quick Voice Cloning?

Voice name must be 1–30 characters, the audio sample must be WAV or MP3, and the file size must be 25 MB or smaller. Use the `ssfm-v30` model unless you have a specific compatibility reason.

How do I set up the server?

Set environment variables `TYPECAST_API_KEY` (required) and `TYPECAST_OUTPUT_DIR` (defaults to `~/Downloads/typecast_output`). Then add the configuration to your MCP client’s settings. For Linux, also add `XDG_RUNTIME_DIR`.

Does it require an API key?

Yes, a Typecast API key is required and must be provided as the `TYPECAST_API_KEY` environment variable.

How many languages does the server support?

The ssfm-v30 model supports 37 languages. The ssfm-v21 model’s language support is not specified in the README.

Comments

More Developer Tools MCP servers

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

Apiosk

obcraft

AI-native payments for tools and APIs. Discover, pay for, execute, and publish monetized APIs directly from your agent, settled per call in USDC over x402, through the Model Context Protocol. payments · finance · x402 ·

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

JiCo for Jira & Confluence – PII-redacting MCP server with Human-in-the-Loop

drkv-com

JiCo for Jira & Confluence: local MCP server for Jira Data Center - redacts personal data before the AI model, holds every write for approval