Salutespeech

MCP server for Sber SaluteSpeech API — speech recognition (STT) and synthesis (TTS). 5 tools.

npm License: MIT

Part of Russian API MCP (50 servers) by @theYahia.

Install

Claude Desktop

{
  "mcpServers": {
    "salutespeech": {
      "command": "npx",
      "args": ["-y", "@theyahia/salutespeech-mcp"],
      "env": { "SALUTESPEECH_API_KEY": "your-base64-key" }
    }
  }
}

Claude Code

claude mcp add salutespeech -e SALUTESPEECH_API_KEY=your-key -- npx -y @theyahia/salutespeech-mcp

Streamable HTTP mode

SALUTESPEECH_API_KEY=your-key npx @theyahia/salutespeech-mcp --http --port=3000
# POST http://localhost:3000/mcp
# GET  http://localhost:3000/health

Auth

Three options (checked in order):

Env var	Format
SALUTESPEECH_API_KEY	Base64-encoded client_id:client_secret
SALUTE_AUTH_KEY	Same (legacy alias)
SALUTE_SPEECH_CLIENT_ID + SALUTE_SPEECH_CLIENT_SECRET	Raw credentials (auto-encoded)

OAuth tokens are obtained and refreshed automatically. The scope defaults to SALUTE_SPEECH_PERS (individuals); set SALUTE_SPEECH_SCOPE for corporate accounts (SALUTE_SPEECH_CORP — postpaid, SALUTE_SPEECH_B2B — prepaid). Get credentials at developers.sber.ru.

Tools (5)

Tool	Description
recognize_speech	STT from Base64 audio
synthesize_speech	TTS, returns Base64 audio
list_models	List recognition models and synthesis voices
get_task_status	Check async recognition task status
recognize_file	STT from a local file path

Skills

• skill-transcribe — guided workflow for audio transcription
• skill-synthesize — guided workflow for speech synthesis

Examples

Transcribe the audio file /tmp/meeting.wav
Synthesize "Hello world" with voice Bys_24000 in wav16 format
List available voices

Limits

recognize_speech / recognize_file use the synchronous endpoint, capped at 2 MB / 1 minute of audio (larger input returns HTTP 413). For multi-channel audio only the first channel is recognized. Longer recordings need the asynchronous flow (data:upload → speech:async_recognize → task:get → data:download) — not yet exposed as tools; get_task_status covers the polling step.

Synthesis input is capped at 4000 characters (incl. spaces and SSML markup).

Troubleshooting

self-signed certificate in certificate chain / UNABLE_TO_VERIFY_LEAF_SIGNATURE

Sber's endpoints use the Russian Trusted Root CA (НУЦ Минцифры), which is not in Node.js's default trust store — so the very first OAuth call fails until you trust it.

Fix: download the root CA (russian_trusted_root_ca_pem.crt) from gosuslugi.ru/crt and point Node at it:

export NODE_EXTRA_CA_CERTS=/path/to/russian_trusted_root_ca_pem.crt

In an MCP client, add it to the server's env block. Do not set NODE_TLS_REJECT_UNAUTHORIZED=0 in production — it disables TLS verification entirely. Official guide: SaluteSpeech certificates.

License

MIT