MCP server for the GigaChat API

GigaChat API

A small Python MCP server for Sber's GigaChat API: authorizes with a Basic key and calls the models directly from an agent, tested on OpenCode under Windows

  • 0 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • It spends paid GigaChat tokens under the user's key
  • The Basic base64 auth key is stored and transmitted by the server
All reasons and checks
Russian stack

gavrsu/gigachat_mcp_server

Install

Services

Manual install

pip install -r requirements.txt

Install Python dependencies.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • It spends paid GigaChat tokens under the user's key
  • The Basic base64 auth key is stored and transmitted by the server

This is third-party code. Review the repository files before installing.

What it does

The server sets up an MCP wrapper over the GigaChat API: on first run it asks for an auth key in Basic base64 format and then works as a regular MCP server for an agent. The repository also ships a Snippets folder with example code from Sber itself (generated via Postman), which the server does not actually use and keeps only as reference material for the API's capabilities: async batch generation, embeddings, file handling, image recognition, AI-text detection, and token balance monitoring.

Who it is for. For people who want to quickly connect GigaChat to an agent over MCP with no cloud intermediary.

Good fit when

  • You need direct GigaChat API access from an agent like OpenCode
  • You have a GigaChat Basic auth key and want a minimal server with no extra scaffolding

Not a fit when

  • You need a mature, tested implementation with tool documentation: the server's README is very short
  • You have no access key for the paid GigaChat API

Example request

Generate a GigaChat response to this request and show the remaining token balance

MCP

Transport
stdio
Authentication
API key

Environment variables

GIGACHAT_AUTH_KEY required, secret
GigaChat auth key in Basic base64 format, requested on the server's first run

Limitations

The top-level README is very short; the tool list and parameters are not documented there, with details deferred to mcp_server/README.md. The Snippets folder with Sber's examples is not used by the server itself, it is just reference material the author left in. It was developed and tested for running on Windows.

How to disable. Stop the server process (start_mcp.bat or python server.py) and remove it from your MCP client config.

FAQ

Does the server use the Snippets folder?

No, those are just Sber's sample code the author kept as a development reference.

Does it work outside Windows?

The README also gives a Linux/Mac command (python server.py), but the main example is a Windows batch file.

How is this GigaChat MCP different from calling the GigaChat API directly?

A small Python server puts an MCP wrapper over Sber's GigaChat API: on first run it asks for an auth key in Basic base64 format, then the agent calls GigaChat models directly. It was tested on OpenCode under Windows.

Does the server use the Snippets folder and does it work outside Windows?

The Snippets folder sits in the repository as examples and the server itself does not use it. Testing was on Windows, a Python server should start on other systems but the author has not confirmed it. Install with pip install -r requirements.txt.

Discussion

No questions or reviews yet.

Official

MCP server that checks text for signs of AI generation through the GigaChat API

MCP serverExtended access5Repository stars
Russian stack

An MCP gateway to GigaChat and YandexGPT with automatic failover between them and 152-FZ personal-data anonymization

MCP serverExtended access1Repository stars
Official

An ai-forever proxy that serves GigaChat through OpenAI, Anthropic and Gemini APIs so Claude Code, Codex and Gemini CLI can run on it

CLIBroad access145Repository stars

Evolution Managed RAG MCP server

Agentic RAG Telegram Bot + MCP Managed RAG

Official

A Cloud.ru teaching MCP server on top of Evolution Managed RAG: hands the agent context from a knowledge base, with a sample GigaChat Telegram bot included

MCP serverExtended access2Repository stars
Russian stack

A local proxy exposing GigaChat through OpenAI- and Anthropic-compatible APIs so it can drive Claude Code, aider and other agents

CLIExtended access

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
MCP server for the GigaChat API (this card)noAPI key0
browser-use-mcp-servernoAPI key848drives a browser through Playwright
MCP server for 1C:NaparniknoAPI key47on Spring Boot, for the 1C:Naparnik API
Kommo CRM MCP servernoOAuth0in Python, with OAuth for Kommo

README in short

The README gives the repository layout, a three-step quick start (install dependencies, run the server, enter the auth key on first run), and a pointer to a separate README inside mcp_server for details, noting the Snippets folder is only Sber's sample code and is not used by the server.

README badge

Report a problem