{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3fgeekz235vc","handle":"tts-mcp","url":"https://wellknown.network/agents/tts-mcp","links":{"self":"https://wellknown.network/agents/tts-mcp/record.json","html":"https://wellknown.network/agents/tts-mcp","markdown":"https://wellknown.network/agents/tts-mcp/record.md","api":"https://wellknown.network/api/v1/agents/tts-mcp","status":"https://wellknown.network/api/v1/agents/tts-mcp/status","claim":"https://wellknown.network/agents/tts-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/tts-mcp/claim.json","badge":"https://wellknown.network/agents/tts-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/tts-mcp/history","tools":"https://wellknown.network/api/v1/agents/tts-mcp/tools"},"ard":{"identifier":"urn:air::server:tts-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"tts-mcp","summary":"Profile-driven MCP server for Google Cloud Text-to-Speech","description":"# tts-mcp\n\nProfile-driven MCP server for **Google Cloud Text-to-Speech**: define one profile per app/client so each tool always speaks with the right voice and settings.\n\nExposes three tools to any MCP client:\n\n- **`tts_speak`** — synthesize text to audio and auto-play it\n- **`tts_doctor`** — run diagnostics on auth, profile, and playback\n- **`tts_stop`** — stop any currently playing audio\n\nVoice, language, model, and format are locked per profile — the LLM can only control text content, speaking rate, and pitch.\n\n## Install\n\n```bash\npip install tts-mcp\n```\n\nOr with [uvx](https://docs.astral.sh/uv/) (no install needed):\n\n```bash\nuvx tts-mcp --help\n```\n\n## Prerequisites\n\n- Python 3.11+\n- A [Google Cloud project](https://console.cloud.google.com/freetrial) with the **Cloud Text-to-Speech API** enabled\n- Google offers a generous free tier — up to **4 million characters/month** for Standard and WaveNet voices, and **1 million characters/month** for Neural2, Polyglot, Chirp 3: HD, and Studio voices, more than enough for most individual use. See [TTS pricing](https://cloud.google.com/text-to-speech/pricing) for details.\n- [Google Cloud CLI](https://cloud.google.com/sdk/docs/install) (`gcloud`) for authentication\n- macOS uses `afplay` for playback by default (configurable via profile)\n\n## Setup\n\n### 1. Authenticate with Google Cloud\n\n```bash\ngcloud auth application-default login\ngcloud auth application-default set-quota-project YOUR_PROJECT_ID\n```\n\nThis stores credentials at `~/.config/gcloud/application_default_credentials.json`, which the TTS client discovers automatically. No environment variables needed.\n\n### 2. Create a profiles file\n\n```bash\ntts-mcp --init\n```\n\nThis creates a starter config at `~/.config/tts-mcp/profiles.json` with example profiles for every Google TTS voice tier. Edit it to pick your voice, format, and playback settings.\n\nThe server finds the profiles file automatically — no `--profiles` flag needed for the common case. The search order is:\n\n1. `--…","publisher":{"name":"Lucas Braga","url":null},"homepage":"https://github.com/that-lucas/tts-mcp","repository":"https://github.com/that-lucas/tts-mcp","version":"0.1.4","license":null,"protocols":["mcp"],"tags":["google-cloud","mcp","model-context-protocol","text-to-speech","tts"],"pricing":null,"endpoints":[{"url":"pypi:tts-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.speech-synthesis","name":"Speech Synthesis","confidence":1,"provenance":"declared"},{"slug":"infra.cloud","name":"Cloud Platforms","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["infra","media","security"],"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":"tts-mcp","registry":"pypi","observedAt":"2026-10-22T22:24:54.083Z","publishedAt":"2026-02-13T10:00:32.257065Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"tts-mcp","url":"https://pypi.org/project/tts-mcp/","firstSeenAt":"2026-09-10T14:23:26.837Z","fetchedAt":"2026-10-22T22:23:35.871Z","normalizedAt":"2026-10-22T22:23:35.871Z"}]},"firstSeenAt":"2026-09-10T14:23:26.837Z","updatedAt":"2026-10-22T22:24:54.083Z"}