Skip to main content
Glama
ru-payroll-mcp

ru-payroll-mcp

ru-payroll-mcp — зарплатный калькулятор РФ для ИИ-агентов

penmadebykisss/ru-payroll-mcp MCP server CI

MCP-сервер, с которым Claude, Cursor и другие ИИ-ассистенты считают зарплату по правилам 2025–2026 годов: сумму на руки и обратно, НДФЛ по прогрессивной шкале 13–22 % нарастающим итогом, страховые взносы работодателя (общий тариф, льготы МСП и IT), полную стоимость сотрудника, отпускные, больничные и компенсацию за неиспользованный отпуск. Всё считается локально, без токенов и отправки данных.

Спросите ассистента:

  • «Кандидат хочет 150 000 на руки — какой оклад ставить и во сколько он обойдётся компании?»

  • «Сколько я получу на руки при зарплате 400 000, и с какого месяца налог станет 15 %?»

  • «Посчитай отпускные: заработок за год 1,2 млн, отпуск 14 дней»

  • «Больничный 10 дней, стаж 6 лет, заработок 1 млн и 800 тыс. за два прошлых года»

Инструменты

Инструмент

Что делает

salary_calc

По окладу: НДФЛ, на руки, взносы и стоимость сотрудника помесячно за год, с премией

salary_from_net

Какой оклад начислить, чтобы на руки была нужная сумма

ndfl_calc

НДФЛ с годового дохода или с отдельной выплаты, разбивка по ступеням и эффективная ставка

vacation_pay

Отпускные по среднему дневному заработку (29,3 дня)

unused_vacation_compensation

Компенсация при увольнении, в том числе расчёт положенных дней

sick_leave_pay

Больничный: средний заработок с лимитами, % по стажу, доля работодателя и Соцфонда

payroll_params

МРОТ, предельная база, шкала НДФЛ, тарифы, лимиты больничных на год

Параметры 2026 года: МРОТ 27 093 ₽, предельная база взносов 2 979 000 ₽ (30 % до неё, 15,1 % сверх), НДФЛ 13 % до 2,4 млн, 15 % до 5 млн, 18 % до 20 млн, 20 % до 50 млн, 22 % сверх; максимальный средний дневной заработок для больничного — 6 827,40 ₽. Льгота МСП 15 % с части зарплаты свыше 1,5 МРОТ с 2026 года действует только для отраслей из перечня Правительства.

Related MCP server: dsh-hr-payroll-mcp

Установка

Нужен Node.js 18+.

Claude Desktop

{
  "mcpServers": {
    "ru-payroll": {
      "command": "npx",
      "args": ["-y", "github:penmadebykisss/ru-payroll-mcp"]
    }
  }
}

Claude Code

claude mcp add ru-payroll -- npx -y github:penmadebykisss/ru-payroll-mcp

Ограничения

  • Не учитываются стандартные вычеты (на детей и др.), районные коэффициенты и северные надбавки — включайте их в сумму начислений сами.

  • Больничный по уходу за ребёнком, декретные и пособия по беременности считаются по другим правилам и здесь не поддерживаются.

  • Результаты справочные: в учётной программе итог может отличаться на копейки из-за округлений.

Проверка

npm test   # эталонные значения посчитаны вручную по НК РФ, 255-ФЗ и Положению № 922

Нужна настройка или доработка?

Подключу этот сервер под ключ: установка, настройка под ваши данные и процессы, доработка под нестандартные поля, ежедневные сводки. Пишите в Telegram @penmadebykisss или оставьте заявку на penmadebykisss.github.io.

Need help setting this up or a custom MCP server? Telegram @penmadebykisss.

English

ru-payroll-mcp is a Russian payroll calculator for AI assistants (2025–2026 rules): net ↔ gross salary with the progressive 13–22 % personal income tax applied year-to-date, employer insurance contributions (general, SME and IT tariffs), total employee cost, vacation pay, sick pay and unused-vacation compensation. Fully local, no API keys.

npx -y github:penmadebykisss/ru-payroll-mcp

Ready-made agent skill: Russian Payroll Calculator on Agensi — free SKILL.md with usage rules and configs for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Codex.

Смотрите также

  • ru-docs-mcp — счета, акты и QR-оплата в PDF

  • ru-business-mcp — проверка контрагентов, курсы ЦБ, производственный календарь

Лицензия

MIT

Available Tools

7 tools
ndfl_calcНДФЛ по прогрессивной шкалеA
Read-onlyIdempotent

НДФЛ резидента с дохода от работы по шкале 2025–2026 годов: 13 % до 2,4 млн, 15 % до 5 млн, 18 % до 20 млн, 20 % до 50 млн, 22 % сверх (в год). Считает налог с годового дохода с разбивкой по ступеням и эффективной ставкой, либо с отдельной выплаты с учётом дохода с начала года (income_before). Для зарплаты целиком удобнее salary_calc. Не учитывает вычеты и доходы с другой шкалой (дивиденды, вклады, продажа имущества). Только вычисление.

Inputs: income (required), income_before.

payroll_paramsМРОТ, предельные базы и ставкиA
Read-onlyIdempotent

Справочные параметры для зарплаты за 2025 или 2026 год: МРОТ, предельная база страховых взносов, 1,5 МРОТ для льготы МСП, шкала НДФЛ, тарифы взносов и максимальный средний дневной заработок для больничных. Используйте, чтобы ответить на вопрос о ставках или проверить исходные данные. Только чтение.

Inputs: year.

salary_calcЗарплата на руки и стоимость сотрудникаA
Read-onlyIdempotent

Считает по окладу (зарплате до вычета налога) помесячно за год: НДФЛ по прогрессивной шкале 13–22 % нарастающим итогом, сумму на руки, страховые взносы работодателя и полную стоимость сотрудника; можно добавить разовую премию в конкретный месяц. Возвращает first_month (на руки в первом месяце), rows по месяцам (видно, когда растёт ставка НДФЛ и когда взносы падают после предельной базы) и totals за год. Обратная задача — salary_from_net. Вычеты на детей не учитываются. Только вычисление, без сети.

Inputs: gross (required), year, bonus, months, +3 more.

salary_from_netОклад по сумме на рукиA
Read-onlyIdempotent

Находит, какую зарплату начислять, чтобы сотрудник получил на руки нужную сумму, с учётом прогрессивного НДФЛ (если с начала года уже выплачено income_before, расчёт идёт по его ставке). Возвращает gross, ndfl, net, взносы и стоимость сотрудника в этом месяце. Используйте при найме, когда кандидат называет сумму «на руки»; прямой расчёт по окладу — salary_calc. Только вычисление, без сети.

Inputs: net (required), year, tariff, accident_pct, +1 more.

sick_leave_payБольничныйA
Read-onlyIdempotent

Пособие по временной нетрудоспособности (255-ФЗ): заработок за два предыдущих года (каждый ограничен предельной базой) / 730, но не ниже МРОТ × 24 / 730; процент по страховому стажу (до 5 лет — 60 %, 5–8 — 80 %, 8+ — 100 %); первые 3 дня оплачивает работодатель, остальные — Социальный фонд. Возвращает average_daily, per_day, employer_part, sfr_part, total, НДФЛ и на руки. Больничный по уходу за ребёнком и по беременности считаются иначе — не для них. Только вычисление.

Inputs: days (required), earnings_prev1 (required), earnings_prev2 (required), insurance_years (required), +2 more.

unused_vacation_compensationКомпенсация за неиспользованный отпускA
Read-onlyIdempotent

Компенсация при увольнении: сколько дней отпуска положено (28 дней в год пропорционально отработанным месяцам, с округлением месяцев по правилу «больше половины — целый»), если дни не заданы явно, и сумма по среднему дневному заработку, НДФЛ и на руки. Средний заработок считается как в vacation_pay. Только вычисление.

Inputs: earnings_12m (required), days, used_days, annual_days, +4 more.

vacation_payОтпускныеA
Read-onlyIdempotent

Отпускные по ст. 139 ТК и Положению № 922: средний дневной заработок = заработок за 12 месяцев / (29,3 × полные месяцы + дни неполных месяцев), умноженный на календарные дни отпуска; плюс НДФЛ и сумма на руки. Возвращает average_daily, gross, ndfl, net. Отпускные выплачиваются не позднее чем за 3 дня до отпуска. Для компенсации при увольнении — unused_vacation_compensation. Индексацию окладов в расчётном периоде учтите в earnings_12m сами. Только вычисление.

Inputs: days (required), earnings_12m (required), full_months, partial_days, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a distinct calculation purpose, and descriptions explicitly cross-reference each other (salary_calc vs salary_from_net as forward/reverse, ndfl_calc as standalone tax, vacation_pay vs unused_vacation_compensation). An agent can reliably pick the right tool.

    Naming Consistency4/5

    Consistent snake_case throughout, but the suffix convention is mixed (_calc for salary_calc/ndfl_calc vs _pay for vacation_pay/sick_leave_pay). Still readable and predictable enough.

    Tool Count5/5

    Seven tools is well-scoped for a payroll calculator domain, with each tool covering a distinct calculation or reference need without redundancy.

    Completeness4/5

    Covers the core payroll lifecycle: gross/net conversion, tax, vacation pay, termination compensation, sick leave, and reference params. Minor gaps remain (child deductions explicitly excluded, no severance or multi-employee/batch support).

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      39 tax tools for US individual taxpayers — federal/state tax calculations, credits, deductions, retirement strategies, audit risk, and tax planning. All calculations run locally, no data leaves the machine. Supports TY2024 and TY2025 (One Big Beautiful Bill Act).
      45
      1,628 npm
      13
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables local-first HR payroll computation with statutory social insurance, housing fund, and cumulative IIT calculations, adaptable to arbitrary spreadsheet headers via import adapters and company profiles. Supports safe performance formula evaluation and keeps PII on-device.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to compute accurate Polish payroll figures, including net-to-gross salary conversions, hourly rates, and statutory tax/ZUS data, matching the results on kalkulatory-place.pl to the cent.
      68 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Russian business data with no API key: company check by INN/OGRN in FNS EGRUL/EGRIP, Bank of Russia exchange rates and key rate, late-payment interest, production calendar with business-day math, and bank details by BIK.
      10
      MIT