@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.

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