Skip to main content
Glama
mitetenov

Bedolaga MCP Server

by mitetenov
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Bedolaga MCP Server

MCP-сервер для получения баланса пользователя из Bedolaga Bot по Telegram ID.

Инструменты (Tools)

Сервер предоставляет три инструмента, доступных через MCP-протокол. Все инструменты readonly — данные не изменяются.

bedolaga_balance

Получить баланс пользователя в рублях по Telegram ID.

Параметры:

Параметр

Тип

Обязательный

Описание

telegram_id

int

Да

Telegram ID пользователя

Возвращает: строку вида 💰 username: 150.00 ₽ (status: active)

Вызов через JSON-RPC:

{
  "method": "tools/call",
  "params": {
    "name": "bedolaga_balance",
    "arguments": { "telegram_id": 123456789 }
  }
}

bedolaga_subscription

Получить статус подписки пользователя по Telegram ID.

Параметры:

Параметр

Тип

Обязательный

Описание

telegram_id

int

Да

Telegram ID пользователя

Возвращает: строку вида 📋 username: tariff=pro, period=monthly, ✅ active

Вызов через JSON-RPC:

{
  "method": "tools/call",
  "params": {
    "name": "bedolaga_subscription",
    "arguments": { "telegram_id": 123456789 }
  }
}

bedolaga_transactions

Получить историю пополнений пользователя по Telegram ID.

Параметры:

Параметр

Тип

Обязательный

Описание

telegram_id

int

Да

Telegram ID пользователя

Возвращает: многострочную строку со списком транзакций:

📋 username — transactions:
  • 500.00 ₽ — Пополнение баланса (2024-01-15T12:00:00)
  • 1000.00 ₽ — Пополнение баланса (2024-01-20T18:30:00)

Вызов через JSON-RPC:

{
  "method": "tools/call",
  "params": {
    "name": "bedolaga_transactions",
    "arguments": { "telegram_id": 123456789 }
  }
}

Related MCP server: Monobank MCP Server

Транспорты

Сервер поддерживает два транспортных протокола:

Транспорт

Файл

Порт

Протокол

Streamable HTTP (новый)

http_server.py

3100

HTTP (REST + SSE)

Stdio (legacy)

bedolaga_server.py

—

stdin/stdout JSON

Streamable HTTP — это современный транспорт MCP, рекомендованный для production. Он позволяет подключаться по HTTP без необходимости запускать дочерний процесс на клиенте.

Требования

  • Python 3.11+

  • Docker (опционально)

  • Развёрнутый Bedolaga Bot с Web API

  • API-ключ от Bedolaga (выдаётся в админ-панели бота)

Быстрый старт

1. Клонировать

git clone https://github.com/mitetenov/bedolaga-mcp.git
cd bedolaga-mcp

2. Настроить

cp .env.example .env
# Заполнить BEDOLAGA_API_URL и BEDOLAGA_API_KEY

3. Запустить

Streamable HTTP (рекомендуется):

# Установить зависимости
pip install -r requirements.txt

# Запустить HTTP-сервер
BEDOLAGA_API_URL=https://your-bot.example.com \
BEDOLAGA_API_KEY=your-key \
python3 http_server.py

Сервер будет слушать на http://0.0.0.0:3100, MCP endpoint доступен по POST /mcp.

Stdio (legacy):

BEDOLAGA_API_URL=https://your-bot.example.com \
BEDOLAGA_API_KEY=your-key \
python3 bedolaga_server.py

Через Docker:

docker compose up -d

Docker-образ по умолчанию запускает Streamable HTTP сервер на порту 3100.

Подключение как MCP-сервер

Streamable HTTP (новый транспорт)

Сервер доступен по HTTP на порту 3100, endpoint: /mcp.

Hermes Agent

# ~/.hermes/config.yaml
mcp_servers:
  bedolaga:
    transport: streamable-http
    url: "http://localhost:3100/mcp"
    env:
      BEDOLAGA_API_URL: "https://your-bot.example.com"
      BEDOLAGA_API_KEY: "your-api-key"

Claude Desktop

{
  "mcpServers": {
    "bedolaga": {
      "type": "streamableHttp",
      "url": "http://localhost:3100/mcp"
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "bedolaga": {
      "transport": "streamable-http",
      "url": "http://localhost:3100/mcp"
    }
  }
}

Проверка через curl

# Инициализация (получить session ID)
curl -s -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}},"id":1}' \
  -D - | grep -i mcp-session-id

# Список инструментов (с session ID)
curl -s -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Вызов инструментов
# Баланс
curl -s -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"bedolaga_balance","arguments":{"telegram_id":123456789}},"id":3}'

# Подписка
curl -s -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"bedolaga_subscription","arguments":{"telegram_id":123456789}},"id":4}'

# Транзакции
curl -s -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"bedolaga_transactions","arguments":{"telegram_id":123456789}},"id":5}'

Stdio (legacy транспорт)

Hermes Agent

# ~/.hermes/config.yaml
mcp_servers:
  bedolaga:
    command: "python3"
    args: ["/path/to/bedolaga-mcp/bedolaga_server.py"]
    env:
      BEDOLAGA_API_URL: "https://your-bot.example.com"
      BEDOLAGA_API_KEY: "your-api-key"

Claude Desktop

{
  "mcpServers": {
    "bedolaga": {
      "command": "python3",
      "args": ["/path/to/bedolaga-mcp/bedolaga_server.py"],
      "env": {
        "BEDOLAGA_API_URL": "https://your-bot.example.com",
        "BEDOLAGA_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / VS Code

Добавить в .cursor/mcp.json или settings.json:

{
  "mcpServers": {
    "bedolaga": {
      "command": "python3",
      "args": ["/path/to/bedolaga-mcp/bedolaga_server.py"],
      "env": {
        "BEDOLAGA_API_URL": "https://your-bot.example.com",
        "BEDOLAGA_API_KEY": "your-api-key"
      }
    }
  }
}

Управление сессиями

Streamable HTTP транспорт использует stateful-сессии по умолчанию (stateless_http=False). После инициализации сервер возвращает заголовок mcp-session-id, который клиент должен передавать во всех последующих запросах.

Если нужен stateless-режим (без отслеживания сессий), отредактируйте http_server.py и установите stateless_http=True.

Переменные окружения

Переменная

Назначение

BEDOLAGA_API_URL

URL Bedolaga Web API

BEDOLAGA_API_KEY

API-ключ Bedolaga

PORT

Порт HTTP-сервера (по умолчанию: 3100)

HOST

Адрес для bind (по умолчанию: 0.0.0.0)

API

Bedolaga Web API: X-API-Key в заголовке, endpoint /users/by-telegram-id/{telegram_id}. Подробнее: https://docs.bedolagam.ru

This server cannot be installed

F
license - not found
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Sentice MCP Server by sentice

    Sentice MCP Serverofficial

    sentice
    F
    license
    -
    quality
    -
    maintenance
    Provides user balance information by connecting to a backend service through the users_balance tool. Built with TypeScript and Express for retrieving financial data.
    Last updated

  • Monobank MCP Server

    akutishevsky
    A
    license
    A
    quality
    C
    maintenance
    Enables integration with Monobank API to check currency exchange rates, view account balances, and retrieve transaction statements through natural language queries.
    Last updated
    3
    101
    6
    MIT

  • telegram-mcp

    chenzhaoxuan0
    A
    license
    -
    quality
    C
    maintenance
    Enables interaction with Telegram Bot API for sending messages, photos, editing messages, answering callbacks, and fetching updates.
    Last updated
    MIT

View all related MCP servers

Related MCP Connectors

  • telegram-mcp

    Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.

  • Player's Bank MCP

    Connect your Player's Bank account to AI via Brazil's Open Finance: balances, statements, cards, inv

  • blockscout-mcp-server

    Provide AI agents and automation tools with contextual access to blockchain data including balance…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mitetenov/bedolaga-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server