telnyx-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@telnyx-mcp find a warm female voice and turn my intro script into an MP3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
telnyx-mcp
A private MCP server that gives an assistant Telnyx text-to-speech: find a voice, synthesise text into an MP3 file, render a whole script with timed pauses, and price a job before running it.
Einrichten — ein Eintrag, kein Clone
npx holt das Paket direkt aus GitHub. Kein Clone, kein Docker, kein Build. Das hier
ist der komplette Vorgang:
{
"mcpServers": {
"telnyx": {
"command": "npx",
"args": ["-y", "git+ssh://git@github.com/m8rzel/telnyx-mcp.git"],
"env": {
"TELNYX_API_KEY": "<dein-key>",
"TELNYX_TTS_OUTPUT_DIR": "/Users/marcel/mcp/telnyx-audio"
}
}
}
}Für Claude Code als Einzeiler:
mkdir -p ~/mcp/telnyx-audio
claude mcp add telnyx -s user \
-e TELNYX_API_KEY=dein-key \
-e TELNYX_TTS_OUTPUT_DIR="$HOME/mcp/telnyx-audio" \
-- npx -y git+ssh://git@github.com/m8rzel/telnyx-mcp.gitTELNYX_TTS_OUTPUT_DIR muss ein existierender absoluter Pfad sein. Die Werkzeuge
geben den Pfad der erzeugten MP3 zurück, nie die Audiodaten — ein relativer Pfad oder
ein Ordner, den es nicht gibt, liefert dem Client eine Dateiangabe, mit der er nichts
anfangen kann. Lässt du die Variable weg, landen die Dateien in
<os-temp>/telnyx-mcp und werden vom System irgendwann aufgeräumt.
-y unterdrückt die Rückfrage „Ok to proceed?“ — ohne das Flag würde npx beim ersten
Start auf eine Eingabe warten, die ein MCP-Client nie gibt, und in einen Timeout laufen.
Zugang zum privaten Repo
Das Repository ist privat, also braucht npx Credentials für den Clone. Es gibt zwei
saubere Wege und eine Notlösung:
Weg | Spec in | Haken |
SSH (empfohlen) |
| Braucht einen entsperrten Schlüssel im |
HTTPS + Keychain |
| Funktioniert nur, wenn |
PAT in der URL |
| Nicht benutzen. Das Token steht im Klartext in der MCP-Config, wird mitgesichert, mitgesynct und landet in jedem Screenshot der Datei. Nur als Notlösung, wenn beides andere ausfällt — und danach das Token rotieren. |
SSH einrichten (einmalig, macOS). Der Punkt ist, dass der MCP-Client als
GUI-Kindprozess startet und nicht die Shell-Umgebung erbt, in der dein ssh-agent
läuft. Mit dem Schlüssel in der Keychain übernimmt der systemweite Agent das:
ssh-add --apple-use-keychain ~/.ssh/id_ed25519und in ~/.ssh/config:
Host github.com
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519UseKeychain yes lässt ssh die Passphrase aus der Keychain holen, statt interaktiv zu
fragen — genau der Fall, in dem ein Kindprozess ohne Terminal sonst hängen bleibt.
Prüfen mit ssh -T git@github.com (muss ohne Passphrase-Prompt durchlaufen) und danach
mit dem echten Aufruf:
TELNYX_API_KEY=dein-key TELNYX_TTS_OUTPUT_DIR="$HOME/mcp/telnyx-audio" \
npx -y git+ssh://git@github.com/m8rzel/telnyx-mcp.gittelnyx-mcp ready. Output directory: … auf stderr heißt: läuft. Strg-C beendet.
HTTPS einrichten. Zuerst nachsehen, was git als Credential-Helper benutzt:
git config --get credential.helper # erwartet: osxkeychain
git credential-osxkeychain # muss existieren (Hinweistext = vorhanden)Steht dort nichts oder etwas anderes, einmal setzen und ein Token hinterlegen:
git config --global credential.helper osxkeychain
git clone https://github.com/m8rzel/telnyx-mcp.git /tmp/telnyx-auth-testBeim Clone fragt git nach Benutzer und Passwort; als Passwort ein Personal Access
Token mit repo-Scope eingeben (nicht das GitHub-Passwort). Es liegt danach in der
Keychain, und npx kommt ohne weitere Eingabe durch. Das Testverzeichnis kannst du
wieder löschen. Prüfen, dass es sitzt: git ls-remote https://github.com/m8rzel/telnyx-mcp.git
läuft ohne Rückfrage durch.
Die Haken dieses Wegs: Das Token hat ein Ablaufdatum, und wenn es abläuft, startet der
Server ohne erkennbaren Zusammenhang nicht mehr. Ein klassisches PAT gilt außerdem für
alle privaten Repos des Kontos, nicht nur für dieses — ein Fine-grained Token mit
Repository-Zugriff nur auf m8rzel/telnyx-mcp und Contents: Read ist die engere Wahl.
Und git config --global wirkt auf jedes Repo auf dem Rechner.
So sieht es aus, wenn die Credentials fehlen: npx bricht mit Exit-Code 128 ab
(der Fehlercode von git clone) und schreibt keine erklärende Meldung in die Ausgabe —
nachgeprüft in einer Umgebung ohne jeden GitHub-Zugang, für git+ssh wie für
git+https. Startet der Server im Client also ohne verständlichen Grund nicht, ist das
der erste Verdacht. Den Aufruf einmal von Hand im Terminal starten, dann steht die
eigentliche Ursache da (Permission denied (publickey) bzw.
could not read Username).
Die radikale Alternative: Repo öffentlich machen und unter @m8rzel/telnyx-mcp auf npm
veröffentlichen — dann wäre der Eintrag schlicht npx -y @m8rzel/telnyx-mcp, ohne jede
Authentifizierung. Das ist eine Entscheidung über Sichtbarkeit, keine technische.
Version festnageln
Ohne Angabe nimmt npx den aktuellen Stand des Standardbranches. Das heißt: Jeder Push
auf main ändert beim nächsten Start ungefragt die laufende Installation. Ein Commit-ish
hinter der URL verhindert das:
git+ssh://git@github.com/m8rzel/telnyx-mcp.git#v1.0.0 ← Tag, empfohlen
git+ssh://git@github.com/m8rzel/telnyx-mcp.git#main ← Branch, gleicht dem Standard
git+ssh://git@github.com/m8rzel/telnyx-mcp.git#a92a2f0 ← Commit, maximal eindeutigFür den produktiven Eintrag gehört ein Tag in die Config. Aktualisieren ist dann ein bewusster Schritt: Tag in der Config hochziehen, Client neu starten.
Startzeit
Gemessen vom npx-Aufruf bis zur initialize-Antwort auf stdout, Node 22, Git-Remote
lokal (die Netzlatenz zu GitHub kommt obendrauf):
Lauf | Zeit | Was passiert |
erster Start, leerer npm-Cache | 12–30 s (4 Messungen: 11,6 / 27,5 / 27,9 / 29,9 s) | Lädt den MCP-SDK-Baum herunter: 92 Pakete, rein netzabhängig |
jeder weitere Start | 0,7–1,5 s |
|
Kompiliert wird nie — deshalb ist dist/ eingecheckt (siehe unten).
Praktisch heißt das: einmal im Terminal starten, bevor du den Eintrag in den Client
schreibst. Danach ist der Cache warm und der Client startet in rund einer Sekunde. Ein
kalter Erststart von bis zu einer halben Minute kann sonst in den Start-Timeout eines
MCP-Clients laufen (bei Claude Code per MCP_TIMEOUT in Millisekunden anpassbar) — der
Server wäre dann nicht kaputt, nur zu langsam, und beim nächsten Versuch sofort da.
Zwei Feinheiten: Ein geänderter Commit-ish (Tag statt Branch) ist ein eigener
Cache-Eintrag, kostet also einmal wieder einen kalten Start. Und ohne Pin ist jeder neue
Commit auf main ebenfalls ein kalter Start.
Warum dist/ im Repository liegt
npx <git-spec> klont, installiert und packt das Paket. Gibt es ein prepare-Script,
installiert npm dafür zusätzlich alle Dev-Abhängigkeiten und kompiliert — bei jedem
kalten Start, auf dem Rechner des Nutzers. Das kostet Zeit und schafft eine Fehlerquelle,
die man aus dem MCP-Client kaum sieht: Schlägt der Build fehl, startet der Server nicht,
und die Meldung dazu versteckt sich in der npx-Ausgabe.
Deshalb liegt das Build-Ergebnis im Repository, package.json hat kein prepare und
files beschränkt das Paket auf dist. Der Preis: npm run build muss vor jedem
Commit laufen, sonst weichen Quelle und Build voneinander ab. Siehe
CONTRIBUTING.md; npm run verify:dist prüft es.
Related MCP server: quick-tts-mcp
Why this exists
The official Telnyx connector ships 43 tools covering numbers, messaging, calls and the
voice AI stack — but none of them generate speech from text. The REST endpoint
POST /v2/text-to-speech/speech is fully capable (4,900+ voices across 13 providers,
binary_output returns audio/mpeg directly), it just is not exposed. This server wraps
exactly that endpoint, plus the pieces you actually need around it: pause handling,
segment joining, duration measurement and cost estimation.
Tools
Tool | Does | Parameters |
| Lists voices from |
|
| Synthesises one text and writes an MP3. Returns the absolute path, bytes, measured duration, character count and estimated cost, plus the MP3 as an audio block (up to 8 MB; off with |
|
| Renders a markdown script with |
|
| Prices a character count, a text or a full script without calling the API. For a script it also returns segment/pause statistics. | one of |
Script format
# Heading — not spoken
Take a slow breath in.
[PAUSE 5]
And let it go.
[PAUSE 12]A line that consists of only
[PAUSE n]becomes exactly n seconds of silence.nmay be decimal, with a dot or a comma ([PAUSE 2,5]).Consecutive markers are added together.
Headings, horizontal rules and lines that mention a marker without being one (the usual "Note:
[PAUSE 2]= 2 seconds" legend) are dropped — never spoken, never timed.Text is packed into segments of at most
max_chars, split only at sentence boundaries. A single sentence longer than the limit is kept whole rather than cut.
Install
Zum Benutzen: nichts installieren, siehe Einrichten. Zum Entwickeln:
git clone git@github.com:m8rzel/telnyx-mcp.git
cd telnyx-mcp
npm install
npm run buildRequires Node 20 or newer. Runtime dependencies: @modelcontextprotocol/sdk and zod —
nothing else, in particular no ffmpeg.
Configure
The API key is read from the environment only. It is never stored in this repository and never appears in a log line or an error message. Without it the server exits immediately with exit code 78.
Variable | Required | Default | Meaning |
| yes | — | Telnyx API key (Portal → Auth → API Keys) |
| no |
| Where MP3 files are written |
| no |
| HTTP timeout per attempt |
| no |
| Attempts per request (429/5xx/network, with backoff) |
| no |
|
|
Wiring a local clone into an MCP client
Der Standardweg ist npx (oben). Wenn du am Code
arbeitest und den Clone statt GitHub einbinden willst:
{
"mcpServers": {
"telnyx": {
"command": "node",
"args": ["/absolute/path/to/telnyx-mcp/dist/index.js"],
"env": {
"TELNYX_API_KEY": "your-telnyx-api-key",
"TELNYX_TTS_OUTPUT_DIR": "/absolute/path/to/audio-output"
}
}
}
}Use absolute paths — the server is started as a child process and inherits no shell. Transport is stdio; stdout is the protocol channel, so all diagnostics go to stderr.
Fallback: mit Docker betreiben
Brauchst du nur, wenn der npx-Weg ausfällt — etwa weil auf dem Rechner kein git mit
GitHub-Zugang eingerichtet ist, der Server strikt isoliert laufen soll oder du eine
feste, lokal gebaute Fassung einfrieren willst. Der Nachteil liegt auf der Hand: ein
Clone, ein Image-Build und ein laufender Docker-Daemon statt einer Zeile in der Config.
Das Image ist ein zweistufiger Build auf node:20-alpine: Die erste Stufe installiert
alles und kompiliert TypeScript, die zweite übernimmt nur node_modules (ohne
Dev-Abhängigkeiten), dist/ und package.json. Kein ffmpeg, kein Port, kein
HEALTHCHECK — ein stdio-Server hat nichts, womit eine Health-Probe reden könnte.
Ein Befehl
git clone https://github.com/m8rzel/telnyx-mcp.git ~/mcp/telnyx-mcp
cd ~/mcp/telnyx-mcp && bash install.shDas ist alles. Kein Dateien-Verschieben, kein JSON-Editieren, kein manuelles Bauen.
Ab dem zweiten Mal genügt ./install.sh — den ersten Lauf startest du über bash,
weil das Ausführungsbit einen git clone nicht zwingend übersteht; das Skript setzt
es dann selbst.
Was dabei passiert:
Schritt | |
1 | Prüft, ob Docker installiert ist und der Daemon antwortet. Sonst Abbruch mit Hinweis auf Docker Desktop. |
2 | Baut das Image |
3 | Legt den Audio-Ordner an: |
4 | Holt den API-Schlüssel aus |
5 | Registriert den Server in Claude Code (falls die CLI |
6 | Rauchtest: startet den Container mit genau der registrierten Befehlszeile und lässt ihn per JSON-RPC die vier Werkzeuge melden. |
7 | Sagt dir, wo die MP3s landen und dass Claude einmal neu starten muss. |
Das Skript ist idempotent: Nach einem git pull lässt du es einfach erneut laufen.
Einen bestehenden telnyx-Eintrag ersetzt es, andere MCP-Server lässt es unberührt —
und von der Claude-Desktop-Konfiguration legt es vor jeder Änderung eine Sicherungskopie
claude_desktop_config.json.bak-<Zeitstempel> an.
Optionen:
bash install.sh --non-interactive # keine Rückfragen (Schlüssel muss vorliegen)
bash install.sh --no-register # nur bauen und testen, nichts registrieren
bash install.sh --helpVon Hand, falls du die Schritte einzeln willst
docker build -t telnyx-mcp .
mkdir -p ~/mcp/telnyx-audio
docker run --rm -i \
-e TELNYX_API_KEY="$TELNYX_API_KEY" \
-e TELNYX_TTS_OUTPUT_DIR="$HOME/mcp/telnyx-audio" \
-v "$HOME/mcp/telnyx-audio:$HOME/mcp/telnyx-audio" \
telnyx-mcpEr wartet dann still auf JSON-RPC über stdin; telnyx-mcp ready. Output directory: … auf
stderr heißt, er läuft. Mit Strg-C wieder raus.
Und so sieht der Eintrag aus, den der Installer schreibt (~/Library/Application Support/Claude/claude_desktop_config.json bzw. claude mcp add):
{
"mcpServers": {
"telnyx": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "TELNYX_API_KEY",
"-e", "TELNYX_TTS_OUTPUT_DIR",
"-v", "/Users/marcel/mcp/telnyx-audio:/Users/marcel/mcp/telnyx-audio",
"telnyx-mcp"
],
"env": {
"TELNYX_API_KEY": "dein-telnyx-api-key",
"TELNYX_TTS_OUTPUT_DIR": "/Users/marcel/mcp/telnyx-audio"
}
}
}
}-e TELNYX_API_KEY ohne Wert reicht die Variable aus dem env-Block durch, damit der
Schlüssel nicht in der Argumentliste eines docker-Prozesses auftaucht.
Drei Stolpersteine
Regel | Warum |
| Ein TTY macht aus stdio ein Terminal: Zeileneditor, Echo und Steuersequenzen landen im Strom und zerlegen die JSON-RPC-Frames. |
Der Audio-Ordner braucht innen und außen denselben absoluten Pfad |
|
| Der MCP-Client startet pro Sitzung einen Container und beendet ihn beim Schließen. Ohne |
Dateirechte
Der Container läuft als unprivilegierter node-User, der im Image mitkommt (uid 1000).
Unter Docker Desktop für macOS gehört der Bind-Mount ohnehin dem aufrufenden Benutzer,
dort ist nichts zu tun. Unter Linux schon: Ist die eigene uid nicht 1000, kann der Server
nicht in das gemountete Verzeichnis schreiben und speak scheitert mit EACCES. Der
Installer erkennt das und ergänzt dort automatisch --user $(id -u):$(id -g). Von Hand:
docker run --rm -i --user "$(id -u):$(id -g)" \
-e TELNYX_API_KEY="$TELNYX_API_KEY" \
-e TELNYX_TTS_OUTPUT_DIR="$HOME/mcp/telnyx-audio" \
-v "$HOME/mcp/telnyx-audio:$HOME/mcp/telnyx-audio" \
telnyx-mcpIn einer MCP-Client-Konfiguration gehören dieselben Flags in das args-Array —
"--user", "501:20" mit den Zahlen aus id -u und id -g, weil $(…) dort nicht
ausgewertet wird.
Optional: Image aus der GHCR statt lokal bauen
Dieser Weg ist noch nicht aktiv. Der Workflow dafür liegt als
.github/docker.yml im Repo — also nicht in .github/workflows/, wo GitHub ihn
ausführen würde. Grund: Dem schreibenden GitHub-Zugang fehlt der workflow-Scope,
ein Push nach .github/workflows/ wird mit 403 insufficient scopes abgelehnt.
Solange die Datei dort liegt, läuft nichts und es existiert kein Image in der GHCR.
Der Standardweg ist deshalb der lokale Build, den install.sh erledigt. Wer den
GHCR-Weg aktivieren will, verschiebt die Datei einmal von Hand und löscht den
erklärenden Kommentarblock an ihrem Anfang:
git mv .github/docker.yml .github/workflows/docker.ymlDanach veröffentlicht jeder Push auf main ghcr.io/m8rzel/telnyx-mcp:latest für
linux/amd64 und linux/arm64; ein v*-Tag veröffentlicht zusätzlich :1.2.3 und
:1.2. Weil dieses Repository privat ist, ist das Package ebenfalls privat — vor dem
Pull einmal anmelden, mit einem Personal Access Token (classic) mit dem Scope
read:packages:
docker login ghcr.io -u m8rzel # Passwort = das Token, nicht das GitHub-Passwort
docker pull ghcr.io/m8rzel/telnyx-mcp:latestSpeaking rate
Telnyx has no single rate field. The rate parameter here is a multiplier
(1 = normal) that is translated per provider:
Voice | How | Range |
|
| 0.5–2.0 |
|
| 0.5–2.0 |
|
| 0.7–1.3 |
| text is wrapped in | 0.2–2.0 |
everything else (Kokoro, Qwen3, Bayan, Sukhan, ElevenLabs, Resemble, Inworld, Fish, xAI) | rejected with an explanation | — |
Only AWS Polly and Azure accept SSML at all. A rate for a voice that cannot do it is an error before any request is sent, rather than a silently ignored parameter — you would otherwise pay for audio at the wrong tempo. Note that the SSML wrapper adds characters, and Telnyx bills per character, so the reported cost includes it.
How the audio is assembled
render_script makes one API call per speech segment and then joins everything on MP3
frame level — no decoding, no re-encoding, no quality loss, no ffmpeg:
Silence is generated as real MPEG Layer III frames that match the format Telnyx returned (version, sample rate, channel mode, bitrate). The payload after each 4-byte header is all zeroes, which with the protection bit set to "no CRC" means
part2_3_length = 0for every granule: the decoder reads no main data and outputs one frame of silence.Pause lengths are quantised to whole frames (24 ms at 24 kHz, 26 ms at 44.1 kHz). The result reports the actual duration, and
requested_secondswhenever it differs.Duration is computed exactly from the frame headers (
samples / sample rate), not estimated from the bitrate.Parts with different sample rates or channel counts are refused instead of being glued into a file that plays at the wrong speed.
That costs ~200 lines of header arithmetic and keeps the dependency list at two packages; requiring ffmpeg for the same job would be a ~70 MB external binary.
scripts/verify-audio.mjs checks this against an independent implementation: ffmpeg
encodes a tone, this code builds the silence and joins the parts, and ffmpeg then decodes
and measures the result. It needs ffmpeg on PATH (or FFMPEG_PATH) and is therefore not
part of npm test:
npm run build && node scripts/verify-audio.mjsCost
Telnyx bills per synthesised character. List prices used by estimate_cost
(source: https://telnyx.com/pricing/text-to-speech):
Tier | USD per character | 14,000-character script |
Telnyx TTS (Kokoro) | $0.000003 | ~$0.04 |
Telnyx Ultra, Qwen3 | $0.000032 | ~$0.45 |
Telnyx HD Voices | $0.000048 | ~$0.67 |
Amazon Polly standard | $0.000009 | ~$0.13 |
Amazon Polly neural | $0.000024 | ~$0.34 |
MiniMax | $0.000034 | ~$0.48 |
Resemble, Murf | $0.000008 | ~$0.11 |
Inworld Mini / Max | $0.0000055 / $0.00001 | ~$0.08 / ~$0.14 |
ElevenLabs and Azure are bring-your-own-key. Using elevenlabs.* or azure.* voices
through Telnyx requires your own provider key stored in your Telnyx account; those
requests are billed by ElevenLabs/Azure, not per Telnyx character. estimate_cost
returns null for them instead of inventing a number.
Limits
Character limit per request is undocumented. The default
max_charsof 1800 is a conservative choice, not a Telnyx specification. Raise it if long segments work for you.Rate limits for this endpoint are undocumented. Segments are synthesised sequentially, never in parallel; 429 responses are retried with backoff and honour
Retry-After.MP3 only.
render_scriptneeds MPEG Layer III to join frames. Voices that return PCM or another format fail with a clear message rather than a corrupt file.Sentence splitting is a regular expression on
. ! ? …followed by whitespace, so an abbreviation like "z. B." can be treated as a sentence end. That only affects where a segment boundary falls, never the spoken text.
Development
npm run lint # eslint, type-aware
npm run build # tsc -> dist/
npm test # vitest, 90 tests, no network
npm run check # all three
npm run verify:dist # baut neu und bricht ab, wenn dist/ vom Commit abweichtdist/ ist eingecheckt (Begründung oben) — jeder
Commit, der src/ berührt, muss das neu gebaute dist/ mitbringen. Details in
CONTRIBUTING.md.
Dependency versions are pinned exactly, so npm install reproduces the tested tree even
though no lockfile is committed. The Docker build follows the same rule: it runs
npm install, and automatically switches to npm ci as soon as a package-lock.json
is committed.
Tests mock the HTTP layer and run against real LAME-encoded MP3 fixtures (base64-embedded
in tests/fixtures/index.ts, so the repository holds no binary blobs), which means the
suite runs offline and without an API key. Regenerate the fixtures with
node scripts/make-fixtures.mjs (needs ffmpeg).
Security
The key lives in
TELNYX_API_KEYonly. There is no key in the code, the tests, the examples or the git history —.envis git-ignored and.env.exampleholds variable names only.Every error message passes through a redaction filter that strips the key and anything shaped like a bearer token before it is returned or logged.
file_nameis reduced to a safe base name; the resolved path is verified to stay inside the configured output directory, so no input can write outside it.Audio is written to disk and referenced by path. Files up to 8 MB are additionally returned base64-encoded as an MCP audio block, so clients without access to this disk (containers, remote agents) get the audio too; larger files — a 30-minute hypnosis script is around 14 MB — are referenced by path only.
TELNYX_TTS_EMBED_AUDIO=falseturns the audio block off.
License
MIT — see LICENSE.
Available Tools
4 toolsestimate_costEstimate synthesis costARead-only
Estimates the list-price cost for a character count, a text or a full [PAUSE n] script — without calling the Telnyx API. Use this before rendering long scripts.
Inputs: voice (required), text, script, max_chars, +1 more.
list_voicesList Telnyx voicesARead-only
Lists available Telnyx text-to-speech voices. The full catalogue has thousands of entries, so results are filtered and paged: pass language ("de"), provider ("telnyx") or a search term. Returns "returned of matched of total" plus a per-provider breakdown.
Inputs: limit, offset, search, language, +1 more.
render_scriptRender a [PAUSE n] script to one MP3A
Renders a markdown script into a single continuous MP3. Lines consisting only of "[PAUSE n]" become n seconds of real silence; text is split at sentence boundaries and synthesised segment by segment, then joined on MP3 frame level without re-encoding. Returns the file path, the measured total duration and the duration of every segment, plus the MP3 as an audio block (up to 8 MB, unless TELNYX_TTS_EMBED_AUDIO=false).
Inputs: voice (required), script (required), rate, language, +5 more.
speakSynthesise speech to an MP3 fileA
Synthesises text with a Telnyx voice and writes an MP3 file. Returns the absolute file path, byte size, measured duration, character count and the estimated list-price cost, plus the MP3 itself as an audio block (up to 8 MB, unless TELNYX_TTS_EMBED_AUDIO=false).
Inputs: text (required), voice (required), rate, language, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool maps to a distinct step in the TTS workflow: discovering voices, synthesising single text, rendering multi-segment scripts, and estimating cost without an API call. The only mild overlap is between speak and render_script, both producing MP3s, but the descriptions make the plain-text vs markdown-script-with-pauses boundary clear.
All names use snake_case and are mostly verb_noun (list_voices, render_script, estimate_cost). The bare verb speak is a minor deviation but still readable and unambiguous in this context.
Four tools is compact and each earns its place in the voice-synthesis flow. Slightly thin — a voice-detail or provider-listing tool could round it out — but nothing feels redundant.
The surface covers the core lifecycle: discover voices, preview cost, synthesise text, and render full scripts with silence insertion. Minor gaps exist (no voice metadata lookup, no output format/quality options beyond MP3, no batch/list of generated files), but agents can work around them.
Maintenance
Related MCP Connectors
Generate English and Chinese speech, split long text, track batch jobs, and download audio.
Text to speech, voice listing and phrase library search for AI assistants. API key header.
Text-to-speech: browse voices and synthesize natural speech from text with ditto.audio.
Text to speech in 200+ languages, voice cloning, voice design and SRT captions.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables text-to-speech conversion using ElevenLabs API with voice management, streaming support, and multiple models.51MIT
- AlicenseNot gradedqualityDmaintenanceProvides text-to-speech functionality using OpenAI's TTS API, enabling text-to-speech conversion, voice listing, and model listing.MIT

leanvox-mcpofficial
AlicenseNot gradedqualityDmaintenanceEnables text-to-speech generation, voice cloning, dialogue creation, and other TTS operations through natural language in MCP-compatible AI assistants.20 npmMIT- AlicenseAqualityBmaintenanceEnables AI agents to generate speech using Gemini TTS models, with tools for text-to-speech, task polling, and pricing checks.4177 npmApache 2.0