Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Finagent — Financial Reports

by finuchetaiversion 0.7.0rc2i★ 0iRuns on your computerRepository ↗
Registry nameio.github.finuchetai/finagent-mcp

How to install

What it does

Read-only profit, cash-flow and balance reports. Demo included; client sources need local setup.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Accounting, finance & tax

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Finagent — Financial Reports. Follow https://mcp.popnx.com/i/finuchetai-finagent-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Finagent — Financial Reports for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "finagent": { "command": "uvx", "args": [ "open-finance-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Finagent — Financial Reports tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "finagent": {
          "command": "uvx",
          "args": [
            "open-finance-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Finagent — Financial Reports and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Finagent — Financial Reports or shows a Finagent — Financial Reports tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Finagent — Financial Reports yet

Finagent — Financial Reports runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Finagent — Financial Reports

  • Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)

B · Others in Accounting, finance & tax that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Finagent — Financial Reports for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user finagent -- uvx open-finance-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Finagent — Financial Reports tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user finagent -- uvx open-finance-mcp
  4. Type /mcp in Claude Code

    You should see Finagent — Financial Reports listed as connected

  5. Try it

    Use Finagent — Financial Reports and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Finagent — Financial Reports or shows a Finagent — Financial Reports tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Finagent — Financial Reports for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "finagent": { "command": "uvx", "args": [ "open-finance-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Finagent — Financial Reports tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Finagent — Financial Reports and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Finagent — Financial Reports or shows a Finagent — Financial Reports tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Finagent — Financial Reports for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "finagent": { "type": "stdio", "command": "uvx", "args": [ "open-finance-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Finagent — Financial Reports tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Finagent — Financial Reports and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Finagent — Financial Reports or shows a Finagent — Financial Reports tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Finagent — Financial Reports💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user finagent -- uvx open-finance-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "finagent": {
      "command": "uvx",
      "args": [
        "open-finance-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "finagent": {
      "command": "uvx",
      "args": [
        "open-finance-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "finagent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "open-finance-mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.7.0rc2
Published to registryi
Nov 14, 2026
Code last changedi
Nov 14, 2026
Maker
finuchetai
Packages
pypi: open-finance-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account finuchetai, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 6 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for open-finance-mcp@0.7.0rc2

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/finuchetai-finagent-mcp.svg)](https://mcp.popnx.com/en/servers/finuchetai-finagent-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 0% of the other 3496 servers in this category
  • Published to the registry more recently than 83% of the other 3496 servers in this category
  • Basic checks equal to or better than 99% of the other 3496 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Finagent — Financial Reports safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 6 days ago, and the latest version (0.7.0rc2) reached the registry 6 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

by SolidInvoiceGrowing★ 990Updated 11 days ago

Runs in the cloud✓ service owner · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 265Updated 12 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 707 Stars for the whole repoUpdated last month

Runs in the cloud✓ service owner · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

by twelvedataGrowing★ 87Updated 16 days ago

Runs in the cloud✓ service owner · twelvedata.com
Compared with similar ones
This one
Finagent — Financial Reports
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to install
Needs a keyNoNoNoNoYesNo
Add with + in ClaudeNoNoNoNoNoYes
Basic checks3/34/64/44/45/54/4
LicenseMITMITNOASSERTIONMITMIT–
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Финагент MCP — финансовые отчёты для AI-ассистента

English · Скачать 0.7.0rc2 · PyPI · Проверки

Посмотреть сервис «Финагент» →

Автономный финансовый MCP от проекта «Финагент»: подключайте подготовленные отчёты к своему локальному AI-ассистенту и задавайте вопросы о прибыли, движении денег и остатках. Для самостоятельного запуска используйте инструкции ниже. Если нужна помощь с подключением данных и управленческим учётом, оставьте заявку на сайте сервиса.

Репозиторий: finagent-mcp. Имя устанавливаемого Python-пакета open-finance-mcp; команды запуска finance_mcp.server сохранены для совместимости с комплектом 0.3.0.

Текущая версия — 0.7.0rc2, предварительный выпуск: демо, адаптеры CSV/XLSX/PostgreSQL и Google Sheets, проверка среды и реестр кодов. Этот каталог целиком переносим: ему не нужны остальной репозиторий, база, домен, ключи или сервисы автора. Источник — вымышленная мастерская «Маяк», два закрытых месяца и один открытый. Даты фиксированы для воспроизводимости.

Что можно подключить

ИсточникЧто нужноЗависит от Google
ДемоУстановить пакет; свои данные не нужныНет
Excel (.xlsx), CSVКарта подготовленных месячных отчётов и сверка с источникомНет
PostgreSQLСогласованные представления, карта данных, роль только на чтение и сверкаНет
Google SheetsOAuth-вход и поддерживаемый формат месячного отчётаДа; проверка доступа ещё рассматривается

Карту и техническую настройку можно поручить своему агенту по AGENTS.md и поэтапной инструкции. Поддержка PostgreSQL не означает поддержку MySQL или Microsoft SQL Server. Примеры вопросов: «Как изменилась выручка?», «Каковы поступления и выплаты за месяц?», «Чем объясняется отличие прибыли от движения денег?» Ответы ограничены доступными отчётами и их методикой. Из одной выписки прибыль не выводится.

Статус Google-подключения

Локальное чтение ДДС через Google Sheets в Codex на Windows проверено у владельца и внешнего тестировщика, включая повторное подключение после перезапуска Codex. 14.11.2026 оформление Google-приложения проверено и опубликовано; заявка на проверку доступа к таблицам находится на рассмотрении Google. Массовый Google-вход пока не объявляется одобренным.

Обычный git clone не включает зарегистрированную OAuth-конфигурацию приложения или готовый Windows-комплект с Start.cmd. Google-подключение требует отдельно полученного комплекта автора либо Desktop-конфигурации через FINANCE_GOOGLE_OAUTH_APP. Демо работает без Google-входа. Настройка и границы поддержки. Политика конфиденциальности.

Установка Google Sheets в Codex на Windows

Готовый комплект finagent-google-codex-0.7.0rc2.zip доступен в предварительном Release. Это отдельный файл: архив source.zip и стандартные Source code архивы GitHub не содержат Start.cmd и настроек Google-приложения автора.

  1. Установите Codex CLI и Python 3.11 или новее. Нужен доступ к интернету.
  2. Скачайте Windows-комплект и полностью распакуйте его в отдельную папку.
  3. Запустите Start.cmd: войдите в Google, укажите ссылку на свою таблицу, выберите отчёт и месяц, подтвердите валюту и денежные единицы.
  4. После успешной настройки перезапустите Codex и откройте новый чат. Попросите: «Прочитай паспорт и доступные месяцы финансового MCP, затем разбери мой отчёт».

Доступ Google ещё на проверке. При отказе или предупреждении о непроверенном приложении остановитесь и передайте автору текст ошибки; обход предупреждения не является шагом установки. Не отправляйте пароли, коды или токены. Старая установка сохраняется отдельно; повторный запуск использует прежний профиль. Таблица только читается. Подробности и ограничения — в инструкции.

Если вы устанавливаете MCP через ассистента

Передайте ему: «Прочитай AGENTS.md и docs/guided-setup.md. Сначала спроси, где я хочу работать: браузер, настольный ChatGPT или другой клиент. Веди меня по одному шагу, объясняй термины и выполняй техническую настройку сам. Не задавай все вопросы о данных одной анкетой. Сначала посмотри разрешённый источник и объясни, что можно подключить».

Поэтапная настройка простыми словами. Неполный ОПиУ, например только до валовой прибыли, поддерживается с явно указанными ограничениями; отсутствие чистой прибыли не требует выдумывать её или дополнять исходник нулями.

Быстрый запуск

Пакет опубликован в PyPI. Для установки без клонирования репозитория:

python3 -m venv .venv

.venv/bin/python -m pip install 'open-finance-mcp[files,postgres]==0.7.0rc2' .venv/bin/python -m finance_mcp.diagnostics stdio --timeout 15

Без конфигурации запускается вымышленное демо. На Windows используйте python и .venv\Scripts\python.exe. Для работы агента с картой источника см. поэтапную настройку. Установка из исходников и запуск тестов:

Нужен Python 3.11+ с venv/pip и доступ к индексу Python-пакетов при первой установке. Скопируйте только этот каталог в отдельное место. Внутри копии:

python3 preflight.py environment

python3 -m venv .venv .venv/bin/python -m pip install . .venv/bin/python -m finance_mcp.diagnostics stdio --timeout 15 .venv/bin/python -m unittest discover -s tests -p test_demo.py -v .venv/bin/open-finance-mcp

Последняя команда ждёт сообщений MCP на stdin; пустой экран — нормально. Завершение: Ctrl+C. Сервер запускается помощником как дочерний процесс; отдельный фоновой сервис и открытый порт ему не нужны. На Windows используйте .venv\Scripts\python.exe.

Подключение к локальному агенту

В настройках MCP клиента, поддерживающего stdio, укажите абсолютный путь к Python созданной venv. Структура конфигурации зависит от клиента; типовой фрагмент:

{

"mcpServers": { "finance-demo": { "command": "/absolute/path/to/demo/.venv/bin/python", "args": ["-m", "finance_mcp.server"] } } }

Рабочая папка клиента может быть любой: код установлен в venv, данных с относительными путями нет. Проверка ниже использует настоящий subprocess из временной рабочей папки. В 0.4.0 добавлен защищённый Streamable HTTP для удалённых клиентов и генератор локального/удалённого плагина. Выбор клиента и самостоятельное размещение. Для браузера потребуются сервер владельца, HTTPS и настроенный OAuth-провайдер; публикация кода сама по себе их не создаёт.

Передайте агенту: «Прочитай AGENTS.md, установи этот пакет в отдельную venv, выполни проверки и помоги добавить stdio MCP в мой локальный клиент. Покажи прибыль и остаток денег за сентябрь 2026 и объясни, почему прибыль отличается от движения денег».

Ожидаемо: прибыль сентября 75000.00 RUB, движение денег 80000.00 RUB, остаток на конец 155000.00 RUB. Это учебные числа; сначала прочитайте паспорт.

Интерфейс адаптера (контракт 1.1)

finance_mcp.contract.FinanceAdapter — Python Protocol без зависимости от MCP SDK:

  • passport() -> str: подтверждённая методика и ограничения одного клиента;
  • periods() -> tuple[Period, ...]: периоды и доступные отчёты;
  • report(kind, month) -> Report: ОПиУ, ДДС или остатки;
  • notes(month) -> str: примечания закрытого периода.

Собственный адаптер передаётся в finance_mcp.server.create_server(adapter). Сервер не знает SQL, таблиц и файлов источника. Без --config CLI запускает DemoAdapter; подключение CSV/XLSX/PostgreSQL выбирается через --config. Контракт не является механизмом авторизации: будущий адаптер обязан обеспечивать права на стороне источника.

Report: тип, период, валюта ISO-кодом, источник, as_of (подтверждённая дата состояния с TZ или null), отдельные received_at / as_of_status / source_time_raw, complete и непустой tuple строк. Строка: устойчивый code, название, разрез, Decimal и статус value/missing/not_applicable. Последние два означают None, в JSON — null, и отличаются от денежного нуля. Пропуск требует complete=false. Уникальность строки — (code, dimension). Итоги имеют собственные коды; правила сложения описывает паспорт, инструмент не складывает строки и не конвертирует валюты. Разные отчёты могут иметь разные валюты, это всегда явно в ответе каждого отчёта.

FinanceService проверяет запрос целиком до загрузки отчётов: 1–12 уникальных периодов, закрытость и доступность отчёта; неверный запрос отклоняется, частичного успешного ответа нет. Проверяется соответствие возвращённого отчёта запросу. Деньги сериализуются строками; ответ — один текстовый JSON без дублирования в structuredContent.

Проверки и границы готовности

Тесты сверяют все 24 строки демо, денежные тождества и разные смыслы нуля/пропуска, подставляют второй адаптер через публичный интерфейс, проверяют отказ на открытый, отсутствующий и испорченный период. Интеграция запускает установленный сервер по stdio, делает initialize/list_tools и вызывает все шесть инструментов, включая отрицательные сценарии и повторный запуск. Никаких подключений к реальным финансовым системам нет.

Перенос: скопируйте preflight.py, README.md, AGENTS.md, pyproject.toml, src/, tests/, docs/ и examples/. Не переносите .venv, build, *.egg-info, кэши или настройки исходного проекта. Удаление установки: остановите MCP в клиенте, уберите его конфигурацию, удалите копию пакета и venv. Секретов и внешних ресурсов это демо не создаёт.

Для публичного выпуска выбрана лицензия MIT; текст — LICENSE. Правообладатель: Самойлова Татьяна. Репозиторий публичный; предварительный выпуск 0.7.0rc2 опубликован. См. порядок выпуска. SDK: официальная документация stdio.

Источники клиента

Установите pip install '.[files,postgres]' внутри venv. Примеры вымышленного клиента «Липа» — examples/lipa: 40 строк, 7 отчётов, две точки. Проверка CSV: python -m finance_mcp.server --config examples/lipa/csv.json --check. В аргументы MCP-клиента добавьте --config и абсолютный путь к JSON. Формат экспорта, Excel, PostgreSQL, права, обновление и полный прогон.

Проверка среды, короткая stdio-проба, даты и постоянные коды. Примеры в examples/lipa: csv-registry.json для реестра и csv-dates.json для неизвестной даты состояния. Шаблон акта сверки фиксирует границы приёмки и согласование владельца; тесты его не подписывают.

Обратная связь и участие

Ошибки описывайте по шаблону, без реальных финансовых данных, персональных сведений и секретов. Инструкция по изменениям: CONTRIBUTING.md. Уязвимости: SECURITY.md. История: CHANGELOG.md.

Самостоятельное использование MCP не требует регистрации в сервисе «Финагент». Ссылка на сервис помогает найти команду проекта и получить помощь с подключением.

Google Sheets (0.5.0)

Прямое чтение одной выбранной книги сервисным аккаунтом владельца и обновление через refresh_source. Оригинал не меняется. Поддерживаются нормализованные диапазоны и согласованная карта широкого отчёта. См. инструкцию. Live-приёмка сервисного аккаунта остаётся отдельным обязательным этапом.

Вход Google без сервисного аккаунта (0.6.0)

Основной путь: агент запускает finance-mcp-google login

Only the beginning is shown; read the rest in the repo