MCP Server | Sarvam API Docs

Sarvam API MCP server

Official Sarvam Model Context Protocol (MCP) server. Exposes every public Sarvam API (STT, TTS, Translate, Transliterate, Language ID, Text Analytics, LLM (30B / 105B), Vision Document Intelligence, Pronunciation Dictionaries) as first-class MCP tools so any MCP-aware client (Claude Desktop, Claude Code, Cursor, Windsurf, Zed) can call Sarvam with zero boilerplate.

Cross-platform Python package: macOS, Windows, and Linux (Python 3.11+).

Quickstart

1. Get your API key

2. Add to your MCP client

Paste this JSON into your favorite agent (Cursor, Claude Desktop, Windsurf, etc.) and it’ll set up Sarvam for you:

1 {
2   "mcpServers": {
3     "sarvam": {
4       "command": "uvx",
5       "args": ["sarvam-mcp"],
6       "env": {
7         "SARVAM_API_KEY": "<YOUR_SARVAM_API_KEY>"
8       }
9     }
10   }
11 }

Replace <YOUR_SARVAM_API_KEY> with your actual API key.

Verify your install

Ask your assistant something that exercises a Sarvam tool, for example:

“Translate ‘good morning’ to Hindi using sarvam.”

Tools

All defaults below reflect the latest non-deprecated models.

Tool	What it does	Default model
`sarvam_stt_transcribe`	Audio file → transcript (5 modes)	`saaras:v3`
`sarvam_tts_speak`	Text → audio file	`bulbul:v3`
`sarvam_tts_stream`	Text → streamed audio	`bulbul:v3`
`sarvam_translate`	Cross-language text translate	`mayura:v1`
`sarvam_transliterate`	Script conversion	—
`sarvam_identify_language`	Language + script detect	—
`sarvam_text_analytics`	Typed Q&A over text	—
`sarvam_llm_complete`	Chat completions	`sarvam-30b`
`sarvam_vision_extract`	Document Intelligence	Sarvam Vision
`sarvam_vision_job_status`	Poll Document Intelligence job	—
`sarvam_pronunciation_list`	List pronunciation dictionaries	—
`sarvam_pronunciation_get`	Get a pronunciation dictionary	—
`sarvam_pronunciation_create`	Create a pronunciation dictionary	—
`sarvam_pronunciation_delete`	Delete a pronunciation dictionary	—

Configuration

Env var	Default	Description
`SARVAM_API_KEY`	—	Required. API key from dashboard.sarvam.ai.
`SARVAM_API_BASE_URL`	`https://api.sarvam.ai`	Override for testing/staging.
`SARVAM_MCP_BASE_PATH`	`~/Desktop`	Where audio/document files land.

Two namespaces

The server exposes tools across two namespaces:

sarvam_tools_* — runtime tools. Call Sarvam APIs to do things (transcribe, speak, translate, etc.).
sarvam_code_* — builder tools. Help you write code that uses Sarvam: docs, endpoint shapes, language lists, code snippets, starter projects.