{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qur49z4dkfgd","handle":"supertonic3-mcp","url":"https://wellknown.network/agents/supertonic3-mcp","links":{"self":"https://wellknown.network/agents/supertonic3-mcp/record.json","html":"https://wellknown.network/agents/supertonic3-mcp","markdown":"https://wellknown.network/agents/supertonic3-mcp/record.md","api":"https://wellknown.network/api/v1/agents/supertonic3-mcp","status":"https://wellknown.network/api/v1/agents/supertonic3-mcp/status","claim":"https://wellknown.network/agents/supertonic3-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/supertonic3-mcp/claim.json","badge":"https://wellknown.network/agents/supertonic3-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/supertonic3-mcp/history","tools":"https://wellknown.network/api/v1/agents/supertonic3-mcp/tools"},"ard":{"identifier":"urn:air::server:supertonic3-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"supertonic3-mcp","summary":"MCP server for Supertonic 3 on-device text-to-speech","description":"# supertonic3-mcp\n\nLocal, on-device TTS for Claude & Cursor, powered by Supertonic 3. No API key. No cloud. An internal tool open-sourced by [Halozen](https://halozen.ai) — we build AI compliance intelligence for construction.\n\n*Not affiliated with Supertone Inc.*\n\nExpose `speak`, `list_voices`, and `list_expressions` to Claude Desktop, Cursor, or any MCP client over **STDIO**.\n\n## Quick start (TTHW < 3 min)\n\n```bash\ngit clone https://github.com/nextic-tech/supertonic3-mcp && cd supertonic3-mcp\npython3 -m venv .venv && source .venv/bin/activate\npip install -e \".[dev]\"\n\n# Optional: pre-download model for offline use (~400MB)\nsupertonic3-mcp preload\n\n# Run MCP server (STDIO)\nsupertonic3-mcp\n```\n\n### Cursor MCP config\n\nAdd to `.cursor/mcp.json` (or Cursor Settings → MCP):\n\n```json\n{\n  \"mcpServers\": {\n    \"supertonic3\": {\n      \"command\": \"/absolute/path/to/supertonic-tts/.venv/bin/supertonic3-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\nFirst server start downloads the Supertonic model into `~/.cache/supertonic3/` unless you ran `preload` first.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `speak` | Synthesize text to a WAV file; returns absolute path + metadata |\n| `list_voices` | Built-in voices (`voice_id`, `gender`) |\n| `list_expressions` | Inline tags (`<laugh>`, `<breath>`, …) with descriptions |\n\n### `speak` parameters\n\n- `text` — 1–5000 characters; expression tags allowed\n- `voice_id` — optional (`M1`, `F1`, …)\n- `language` — ISO 639-1 (`en`, `ko`, `ja`, …). **For non-English text, always set `language=`.** Defaults to `en`.\n- `speed` — `0.7` to `2.0` (SDK range)\n- `play` — if `true`, plays audio on **this machine** via `afplay` (macOS) or `aplay` (Linux). Unsupported on Windows.\n\nWAV files are written to `/tmp/supertonic_*.wav` (macOS/Linux). Windows is not supported for synthesis output paths in v1.0.\n\nExample return:\n\n```text\nAudio saved to /tmp/supertonic_abc123.wav (1.4s, voice: M1, lang: en)\n```\n\n## Performance (this repo)\n\nMeasured on Apple M3,…","publisher":null,"homepage":"https://github.com/nextic-tech/supertonic3-mcp","repository":"https://github.com/nextic-tech/supertonic3-mcp/issues","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["fastmcp","local-ai","mcp","on-device","speech","supertonic","text-to-speech","tts"],"pricing":null,"endpoints":[{"url":"pypi:supertonic3-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.speech-synthesis","name":"Speech Synthesis","confidence":1,"provenance":"declared"},{"slug":"infra.devices","name":"Devices & IoT","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","infra","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"supertonic3-mcp","registry":"pypi","observedAt":"2026-10-22T21:25:17.165Z","publishedAt":"2026-06-19T16:36:58.304119Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"supertonic3-mcp","url":"https://pypi.org/project/supertonic3-mcp/","firstSeenAt":"2026-09-10T13:20:12.519Z","fetchedAt":"2026-10-22T21:23:37.669Z","normalizedAt":"2026-10-22T21:23:37.669Z"}]},"firstSeenAt":"2026-09-10T13:20:12.519Z","updatedAt":"2026-10-22T21:25:17.165Z"}