GigaChat MCP: Documentation

Updated: 24 July 2026

Connection

npx -y @theyahia/gigachat-mcp (stdio only). Auth: GIGACHAT_AUTH_KEY — a Base64 client_id:client_secret string from the developers.sber.ru dashboard. The server exchanges it for an OAuth token and refreshes it on expiry.

Tools

8 tools: chat (text generation with conversation support), list_models (available models), embed_text (text embeddings), get_token_count (token counting), generate_image (image generation), get_balance (remaining quota), list_assistants (assistant catalog), file_upload (file upload for multimodal processing).

Agent flow

"Count the tokens in this text before sending it", "generate an image from this description", "show my remaining balance and the list of available models".

Note

A community project (theYahia). ⚠ Sber has no official GigaChat MCP server — this is an independent wrapper over the public REST API, not affiliated with Sber. Stdio transport only; no HTTP mode is implemented. Current version: 3.0.1 (April 1, 2026).