Log inSubmit server
Gemini Tts MCP logo

Gemini Tts MCP

Connects MCP-compatible assistants to RunAPI Gemini TTS for audio tasks, status polling, and pricing checks.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Gemini Tts MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gemini-tts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/gemini-tts-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @runapi.ai/gemini-tts-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 4d ago.

Overview

The gemini-tts-mcp MCP server connects MCP-compatible assistants to RunAPI’s Gemini TTS models through a focused stdio server. It creates text-to-speech tasks, optionally waits for terminal results, retrieves task status, and checks current pricing. Task operations use RunAPI authentication, while pricing lookup works without sign-in. Reach for it when an agent needs Gemini TTS access without exposing the broader RunAPI model catalog.

Use cases

  • Create Gemini TTS audio-generation tasks
  • Poll asynchronous task results
  • Check model and endpoint pricing
  • Run text-to-speech workflows from MCP-compatible hosts

Key features

  • Create Gemini TTS tasks
  • Optionally wait for terminal status
  • Retrieve task payloads and status
  • Check current pricing without sign-in
  • Support two documented Gemini TTS models

Tools3

What Gemini Tts MCP lets your agent do. Expand a tool for its parameters.

Self-reported~72 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @runapi.ai/gemini-tts-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads458Package downloads in the last 30 days.
Last commit24d agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed3Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Gemini Tts MCP works

What gemini-tts-mcp does

The gemini-tts-mcp MCP server gives an MCP-compatible host access to RunAPI’s Gemini TTS model line. It supports one RunAPI endpoint and two documented model variants: gemini-2.5-pro-tts and gemini-3.1-flash-tts.

The server is intended for agents that need to submit text-to-speech work, inspect asynchronous results, or review pricing before creating a task. It keeps the available model scope limited to Gemini TTS rather than exposing the full RunAPI catalog.

How it works

The server runs over stdio and can be added to an MCP host with the @runapi.ai/gemini-tts-mcp npm package. An assistant can call text_to_speech to create a task. That call can either return after submission or wait for a terminal status, and its response includes the task ID, status, and output URLs when available.

For work submitted without waiting, get_task retrieves the current status and latest payload using the task ID. check_pricing looks up current pricing for a Gemini TTS model and endpoint and does not require authentication.

Setup and configuration

The package can be launched with npx using this MCP configuration:

config.json
{
  "mcpServers": {
    "gemini-tts": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/gemini-tts-mcp"]
    }
  }
}

Claude Code can add the server at user or project scope with its claude mcp add command. The same stdio command is documented for Codex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts.

For authenticated operations, credentials are resolved from RUNAPI_API_KEY first, then from ~/.config/runapi/config.json. The MCP login tool can open a browser sign-in and save credentials in that file. Headless environments can set RUNAPI_API_KEY before launching the host. A pre-provisioned configuration file may contain an apiKey field. Real keys should not be committed to source control.

Tools and capabilities

  • text_to_speech: Creates a Gemini TTS task and optionally waits for completion. Supported models are gemini-2.5-pro-tts and gemini-3.1-flash-tts.
  • get_task: Reads the current state and latest response data for an existing task.
  • check_pricing: Returns current pricing information for a Gemini TTS model and endpoint without requiring sign-in.

The gemini-tts-mcp MCP server is suitable for conversational workflows where an agent first checks price, submits audio generation, and then reports the task ID or output URLs.

Limitations and notes

Task creation and status polling require RunAPI authentication; pricing lookup remains available without a key. Model availability can change between releases, so clients should use check_pricing or the RunAPI Gemini TTS model page for the current catalog. The package covers Gemini TTS rather than the complete RunAPI model collection.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Gemini Tts MCP

gemini-tts-mcp is an MCP server that connects MCP-compatible assistants to RunAPI’s Gemini TTS API. Its main tools are text_to_speech for creating audio-generation tasks, get_task for reading task status and payloads, and check_pricing for current model and endpoint pricing. Authentication is needed for task operations, but not pricing.

Install it by configuring your MCP host to run `npx -y @runapi.ai/gemini-tts-mcp`. The README provides a stdio configuration using `npx` and documents setup commands for Claude Code, along with equivalent configuration for other supported hosts.

Authenticate with the MCP `login` tool or set `RUNAPI_API_KEY` before starting the MCP host. Login saves credentials to `~/.config/runapi/config.json`, and the server checks the environment variable before that file. Task creation and status polling require authentication.

Yes, `check_pricing` works without sign-in. It looks up current pricing for a Gemini TTS model and endpoint, while `text_to_speech` and `get_task` require authenticated RunAPI access.

It documents `gemini-2.5-pro-tts` and `gemini-3.1-flash-tts` for `text_to_speech`. Model availability may change between releases, so use `check_pricing` or the RunAPI Gemini TTS model page to verify the current catalog.

Related MCP servers

All in Text-to-Speech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGemini Tts MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gemini-tts-mcp?style=directory)](https://allmcps.com/mcp/gemini-tts-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/gemini-tts-mcp"><img src="https://allmcps.com/api/badge/gemini-tts-mcp?style=directory" alt="Gemini Tts MCP on AllMCPs" /></a>