> For clean Markdown of any page, append `.md` to the page URL.
> For a complete documentation index, see https://docs.sarvam.ai/llms.txt.
> For full documentation content in one file, see https://docs.sarvam.ai/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server.

# MCP Server

> Connect Claude Desktop, Claude Code, Cursor, Windsurf, Zed, and other AI clients to Sarvam through MCP — call every Sarvam API as a tool.

## Sarvam API MCP server

Official Sarvam [Model Context Protocol](https://modelcontextprotocol.io) (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

Sign up or log in at [dashboard.sarvam.ai/key-management](https://dashboard.sarvam.ai/key-management) and copy 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:

```json
{
  "mcpServers": {
    "sarvam": {
      "command": "uvx",
      "args": ["sarvam-mcp"],
      "env": {
        "SARVAM_API_KEY": "<YOUR_SARVAM_API_KEY>"
      }
    }
  }
}
```

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](https://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.

## Related pages

* [Context7](/api-reference-docs/developer-tools/context7)
* [llms.txt & Markdown docs](/api-reference-docs/developer-tools/llms-txt)
* [SDKs & Libraries](/api-reference-docs/getting-started/sd-ks-libraries)
* [Errors & Troubleshooting](/api-reference-docs/errors-troubleshooting)