What can you do with this server?

This MCP server provides speech recognition (STT) and synthesis (TTS) via Yandex SpeechKit, plus utilities for managing voices. * Recognize speech: Convert Base64 audio (oggopus/lpcm) to text using recognize (supports ru-RU, en-US, tr-TR, kk-KK). * Synthesize speech: Convert text (up to 5000 chars) to Base64 audio (oggopus/lpcm/mp3) with configurable voice, speed, and emotion using synthesize. * List available voices: Fetch TTS voices, optionally filtered by language prefix (e.g., ru, en) using list_voices. * High-level transcription: Get clean text from audio with the skill_transcribe tool (can return raw API response if needed). * High-level synthesis: Generate speech with smart defaults and automatic language detection from voice using skill_synthesize (defaults to mp3 format).

Which integrations are available for this server?

Provides speech recognition (STT), speech synthesis (TTS), and voice listing using Yandex SpeechKit API, enabling audio transcription, text-to-speech conversion, and voice management.

How do I use @theyahia/yandex-speechkit-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@theyahia/yandex-speechkit-mcp Transcribe this audio file" 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.

🗄 Repository archived
Development has moved to theYahia/YaAll — a build where the entire Yandex layer lives in one place: its own MCP servers, Claude Code skills, and materials from Yandex's official sets.
The current version of what was here: mcp/yandex-speechkit-mcp/
The npm package is the same — @theyahia/yandex-speechkit-mcp, installs and works as before. Nothing is updated here anymore. Issues and pull requests go to YaAll.
Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at mcp/yandex-speechkit-mcp/. The npm package @theyahia/yandex-speechkit-mcp is unchanged. Please open issues and pull requests there.

This server is part of the theYahia/YaAll build — the entire Yandex layer in one repository: ten MCP servers, Claude Code skills for SEO and demand validation, plus materials from Yandex's official servers. Here it lives separately, there — alongside the rest: mcp/yandex-speechkit-mcp/
Part of theYahia/YaAll — the whole Yandex stack in one repo.

@theyahia/yandex-speechkit-mcp

MCP server for Yandex SpeechKit API — speech recognition, synthesis, and voice listing. 5 tools.

Part of the Russian API MCP series by @theYahia.

Related MCP server: salutespeech-mcp

Installation

Claude Desktop

{
  "mcpServers": {
    "yandex-speechkit": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-speechkit-mcp"],
      "env": {
        "YANDEX_SPEECHKIT_API_KEY": "your-api-key",
        "FOLDER_ID": "your-folder-id"
      }
    }
  }
}

Claude Code

claude mcp add yandex-speechkit \
  -e YANDEX_SPEECHKIT_API_KEY=your-api-key \
  -e FOLDER_ID=your-folder-id \
  -- npx -y @theyahia/yandex-speechkit-mcp

Streamable HTTP (remote / Docker)

YANDEX_SPEECHKIT_API_KEY=... FOLDER_ID=... npx @theyahia/yandex-speechkit-mcp --http
# Listens on :8080/mcp (override with PORT env var)

Smithery

Deploy via smithery.ai — config in smithery.yaml.

Authentication

Variable	Description
`YANDEX_SPEECHKIT_API_KEY`	Yandex Cloud API key (preferred)
`YANDEX_API_KEY`	Legacy alias (still works)
`IAM_TOKEN`	Short-lived IAM token (alternative to API key)
`FOLDER_ID`	Yandex Cloud folder ID (required)
`YANDEX_FOLDER_ID`	Legacy alias for FOLDER_ID

Get credentials at Yandex Cloud Console.

Tools (5)

Tool	Type	Description
`recognize`	Core	Speech recognition (STT) — Base64 audio to text
`synthesize`	Core	Speech synthesis (TTS) — text to Base64 audio
`list_voices`	Core	List available TTS voices, filter by language
`skill_transcribe`	Skill	High-level transcription — returns clean text
`skill_synthesize`	Skill	High-level synthesis — smart defaults, auto-detects language from voice

Examples

Transcribe this audio file
Synthesize "Hello, how are you?" with voice filipp
What voices are available in Russian?
Speak this text using the alena voice

Development

npm install
npm run build
npm test
npm run dev    # stdio mode

License

MIT

Available Tools

5 tools

list_voicesB

List available TTS voices. Optionally filter by language.

Inputs: lang.

recognizeC

Speech recognition (STT) via Yandex SpeechKit. Takes Base64 audio, returns text.

Inputs: audio_base64 (required), lang, format.

skill_synthesizeB

High-level speech synthesis skill. Smart voice defaults, auto-detects language.

Inputs: text (required), voice, lang, format.

skill_transcribeC

High-level transcription skill. Returns clean text from audio.

Inputs: audio_base64 (required), lang, format, return_raw.

synthesizeC

Speech synthesis (TTS) via Yandex SpeechKit. Takes text, returns Base64 audio.

Inputs: text (required), lang, voice, format, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored 2026-05-29 23:55 across 5 tools

Disambiguation4/5

Tools are mostly distinct: list_voices (voice listing), recognize (low-level STT), synthesize (low-level TTS), skill_synthesize (high-level TTS), skill_transcribe (high-level STT). The high-level vs low-level distinction is clear in descriptions, but an agent might hesitate between skill_synthesize and synthesize.

Naming Consistency3/5

Naming is inconsistent: list_voices follows verb_noun pattern, recognize and synthesize are single verbs, skill_synthesize and skill_transcribe have a 'skill_' prefix. Mix of patterns could confuse agents.

Tool Count5/5

5 tools is appropriate for a speech kit server. It covers both STT and TTS with low-level and high-level options, without being overwhelming.

Completeness4/5

Core STT and TTS functionality is covered. Minor gaps like explicit language detection or streaming aren't present but are not critical given the high-level tools handle auto-detection.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

VoiceHue text to speechA
io.github.voicehue
Remote text-to-speech MCP server with text_to_speech and list_voices tools. Free plan.
Text-to-Speech Audio Processing Speech Processing
81
https://voicehue.com/mcp
Vibe2Text — AI audio & video transcription with speaker diarization
ru.vibe2text
Audio & video to text, Russian-first: diarization, timestamps, summary, action items, subtitles.
Speech Processing Text Summarization Multimedia Processing
1
https://api.vibe2text.ru/mcp/
DevX Agent HubA
com.madebydevx.agents
x402 pay-per-call agent tools: token safety/honeypot check, speech to text, TTS, translate, OCR, web
Speech Processing Language Translation Blockchain
231
https://agents.madebydevx.com/mcp
UtteraA
ai.uttera
Audio for your agent: transcribe, speak, translate, summarise, plus sound effects and music.
Audio Processing Speech Processing Language Translation
131
https://mcp.uttera.ai/mcp

Related MCP Servers

mcp-salutespeech
Speech Processing Text-to-Speech
trashchenkov
A
license
Not graded
quality
D
maintenance
Provides speech recognition and synthesis tools via SaluteSpeech API, enabling AI assistants to handle voice input and output.
Updated 2 years ago (2025-05-07 06:41 UTC)
4
MIT
salutespeech-mcp
Speech Processing Text-to-Speech
theYahia
A
license
A
quality
B
maintenance
Provides speech recognition (STT) and synthesis (TTS) tools via the Sber SaluteSpeech API, enabling audio transcription and voice generation through natural language.
Updated 2 months ago (2026-09-03 04:46 UTC)
5
52 npm
1
MIT
RunAPI Gemini TTS MCP Server
Text-to-Speech Speech Processing Audio Processing
runapi-ai
A
license
A
quality
B
maintenance
Enables AI agents to generate speech using Gemini TTS models, with tools for text-to-speech, task polling, and pricing checks.
Updated 20 days ago (2026-10-22 07:52 UTC)
4
177 npm
Apache 2.0
elevenlabs-mcp
carlosvidal
F
license
Not graded
quality
D
maintenance
Provides tools for generating speech from text using the ElevenLabs API, including voice listing, text-to-speech conversion, and quota checking.
Updated 7 months ago (2026-03-31 13:48 UTC)
-

🗄 Repository archived