Skip to main content
Glama
supertonic3-mcp

supertonic3-mcp

by Halozen-Inc

supertonic3-mcp

Local, on-device TTS for Claude & Cursor, powered by Supertonic 3. No API key. No cloud. An internal tool open-sourced by Halozen — we build AI compliance intelligence for construction.

Not affiliated with Supertone Inc.

Expose speak, list_voices, and list_expressions to Claude Desktop, Cursor, or any MCP client over STDIO.

Quick start (TTHW < 3 min)

git clone https://github.com/nextic-tech/supertonic3-mcp && cd supertonic3-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Optional: pre-download model for offline use (~400MB)
supertonic3-mcp preload

# Run MCP server (STDIO)
supertonic3-mcp

Cursor MCP config

Add to .cursor/mcp.json (or Cursor Settings → MCP):

{
  "mcpServers": {
    "supertonic3": {
      "command": "/absolute/path/to/supertonic-tts/.venv/bin/supertonic3-mcp",
      "args": []
    }
  }
}

First server start downloads the Supertonic model into ~/.cache/supertonic3/ unless you ran preload first.

Related MCP server: Kokoro MCP Server

Tools

Tool

Description

speak

Synthesize text to a WAV file; returns absolute path + metadata

list_voices

Built-in voices (voice_id, gender)

list_expressions

Inline tags (<laugh>, <breath>, …) with descriptions

speak parameters

  • text — 1–5000 characters; expression tags allowed

  • voice_id — optional (M1, F1, …)

  • language — ISO 639-1 (en, ko, ja, …). For non-English text, always set language=. Defaults to en.

  • speed — 0.7 to 2.0 (SDK range)

  • play — if true, plays audio on this machine via afplay (macOS) or aplay (Linux). Unsupported on Windows.

WAV files are written to /tmp/supertonic_*.wav (macOS/Linux). Windows is not supported for synthesis output paths in v1.0.

Example return:

Audio saved to /tmp/supertonic_abc123.wav (1.4s, voice: M1, lang: en)

Performance (this repo)

Measured on Apple M3, supertonic 1.3.1 — see benchmark/results.md.

Scenario

Median FSL

Warm (model loaded)

~0.82s

Cold (new TTS() per call)

~0.81s

FSL = time from synthesize() through WAV written (no streaming, no play=True).

Re-run: python benchmark/run.py

Offline use

supertonic3-mcp preload

Downloads ONNX weights atomically to ~/.cache/supertonic3/ and prints SHA256 checksums. After preload, synthesis works without network access.

Development

pip install -e ".[dev]"
pytest

Tests mock the Supertonic SDK (no network in CI).

Coming in v1.1

  • listen() — Whisper speech-to-text (pip install supertonic3-mcp[stt])

  • SSE transport + Docker image for remote agents

  • PyPI publish workflow

License

MIT (this package). Supertonic SDK is MIT; model weights use OpenRAIL-M.

Disclaimer

AI-generated speech is not a substitute for certified safety, legal, or medical guidance. For demonstration purposes only.

Available Tools

3 tools
list_expressionsA

List inline expression tags (e.g. ) usable inside speak() text.

Inputs: no named parameters. Returns: result

list_voicesA

List built-in Supertonic voice styles.

Inputs: no named parameters. Returns: result

speakA

Convert text to speech and save a WAV file. Returns the absolute path and metadata.

Inputs: text (required), play, speed, language, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: listing voice styles, listing expression tags, and performing text-to-speech conversion. No overlap or ambiguity between the tools.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: list_voices, list_expressions, and speak. The naming is predictable and uniform.

    Tool Count5/5

    With only three tools, the server is well-scoped for a text-to-speech domain. Each tool is essential and earns its place.

    Completeness5/5

    The tool set covers the core workflow: discovering available voices and expressions, then speaking text. No obvious gaps for the stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Adds text-to-speech capabilities to Cursor IDE, allowing your AI assistant to speak responses, summaries, and explanations out loud using OpenAI or ElevenLabs.
      1
      Apache 2.0
    • A
      license
      A
      quality
      F
      maintenance
      MCP server for the Supertone TTS API. Generate natural speech, browse and preview the voice catalog, predict synthesis cost, and create cloned voices — directly from Claude Desktop, Cursor, or any MCP-compatible client. Supports Korean, English, Japanese, and 20+ other languages, with speed, pitch, and emotion-style control.
      14
      37 PyPI
      4
      MIT