drebedengi-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DREBEDENGI_LOGIN | Yes | E-mail for login | |
| DREBEDENGI_API_ID | Yes | API ID from drebedengi support (demo_api is only for the demo account) | |
| DREBEDENGI_ENV_FILE | No | Path to another .env file | |
| DREBEDENGI_PASSWORD | Yes | Password | |
| DREBEDENGI_READONLY | No | 1 enables read-only mode; write tools are not registered | |
| DREBEDENGI_REF_CHECK_MS | No | How often to check the reference data revision in milliseconds | 600000 |
| DREBEDENGI_DEFAULT_ACCOUNT | No | Default account for add_expense / add_income | |
| DREBEDENGI_MIN_INTERVAL_MS | No | Minimum pause between API requests in milliseconds | 1000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Доступ к домашней бухгалтерии drebedengi.ru. Суммы — в единицах валюты (рубли, не копейки). Счета (места хранения), категории, источники и теги можно указывать по id или по названию. Перед добавлением операции, если не уверен в названии категории/счёта, вызови list_categories / list_accounts. Перед удалением или изменением операций подтверждай действие у пользователя.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_balanceA | Текущие (или на дату) остатки по счетам — по каждой валюте счёта — и итоги по валютам. Долги (кто кому должен) возвращаются отдельным списком debts и в итоги счетов не входят. |
| list_accountsA | Список счетов (кошельки, карты, банки) с id. Остатки — через get_balance. |
| list_categoriesB | Дерево категорий расходов (kind=expense) или источников дохода (kind=income) с полными путями. |
| list_tagsC | Список тегов (меток) с id. |
| list_currenciesB | Валюты пользователя с курсами к основной валюте. |
| get_transactionsA | Операции (расходы, доходы, переводы, обмен валют) за период с фильтрами. Суммы: расход < 0, доход > 0. Возвращает также суммы расходов/доходов по валютам по всем найденным операциям. |
| get_reportA | Суммы расходов по категориям (group_by=category) или доходов по источникам (group_by=source) за период, с опциональным усреднением по месяцам/неделям/дням и конвертацией в одну валюту. Строки родительских категорий включают дочерние. |
| add_expenseC | Записать расход. amount — положительное число в валюте (например 349.90). |
| add_incomeC | Записать доход. amount — положительное число в валюте. |
| add_transferB | Перевести деньги с одного счёта на другой (в одной валюте). |
| add_currency_exchangeC | Обмен валюты: продано from_amount в from_currency, получено to_amount в to_currency. |
| update_transactionB | Изменить расход или доход по id (только переданные поля). category — категория для расхода или источник для дохода. |
| delete_transactionA | Удалить операцию по id. Для перевода/обмена удаляются обе половины. Необратимо. |
| create_categoryB | Создать категорию расходов (kind=category), источник дохода (source), счёт (account) или тег (tag). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Most tools target clearly different operations: transaction listing vs. reporting, and add_expense/add_income/add_transfer/add_currency_exchange are distinct. The main ambiguity is create_category, which actually creates categories, income sources, accounts, or tags, making its name narrower than its behavior. get_transactions and get_report could be slightly confused but descriptions clarify that one returns raw operations and the other aggregates.
Most names follow a predictable verb_noun pattern: get_balance, list_accounts, update_transaction, delete_transaction, add_expense, etc. Minor deviations exist: add_* is used for recording transactions while create_category is used for setup entities, and create_category itself is overloaded across multiple entity types. The convention is still readable overall.
14 tools is a well-scoped set for a personal finance server, covering accounts, categories, tags, currencies, transactions, transfers, exchanges, and reports. No tool feels obviously redundant or out of place.
Core transaction workflows are covered: add, list, update, delete, transfer, exchange, and reporting. However, several domain entities have create/list but no update or delete operations: categories, accounts, tags, and currencies cannot be modified or removed after creation. This creates notable lifecycle gaps for setup and maintenance operations, even if day-to-day transaction recording is complete.