FinContext MCP

Self-hosted financial context for a business: cash position across Tochka and MoySklad, statement-to-ledger reconciliation and cash-gap forecasting

  • 0 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Reads statements, balances and ledger data across all connected business accounts
  • Needs read-only bank and accounting tokens, even though they stay in the client's own cloud
All reasons and checks
Russian stack

alterfo/fincontext-mcp

Install

Manual install

npm run build && cd infra && terraform init && terraform apply

Build the functions and deploy the Terraform module into your own Yandex Cloud; set cloud_id and folder_id in terraform.tfvars.

Access and checks

How we review

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

  • Reads statements, balances and ledger data across all connected business accounts
  • Needs read-only bank and accounting tokens, even though they stay in the client's own cloud

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

What it does

The server deploys via a Terraform module into the client's own Yandex Cloud: Cloud Functions, API Gateway, YDB and Lockbox for read-only bank and accounting tokens. The agent gets four MCP tools: current cash position across connected accounts, checking a specific payment, reconciling a bank statement against accounting data, and a cash-gap forecast. Base Tochka and MoySklad connectors are open; the reconciliation and forecast engine plus 1C and Kontur are behind a Pro license verified offline with no call to the developer. There is a demo mode on a frozen fixture with no real tokens.

Who it is for. For Russian small and mid-size businesses that want a real cash view across accounts and statement reconciliation through an agent, without handing tokens to a third party.

Good fit when

  • You need a quick real cash total across all accounts
  • You need to check whether a specific payment went through
  • You need a near-term cash-gap forecast

Not a fit when

  • You have no Yandex Cloud account and no wish to run the Terraform module yourself
  • You need reconciliation and forecasting for free: those are proprietary Pro features
  • You need banks or accounting systems other than Tochka and MoySklad: not yet available

Example request

Show the real cash position across all accounts and tell me whether yesterday's payment to the supplier went through

MCP

Transport
http
Authentication
key is optional

Environment variables

LOCKBOX_TOCHKA_TOKEN secret
Read-only Tochka API token, stored in Lockbox in production
LOCKBOX_MOYSKLAD_TOKEN secret
Read-only MoySklad API token
FINCONTEXT_PRO_KEY secret
Offline Pro key, unlocks reconciliation and cash-gap forecast
REPORT_CURRENCY
Reporting currency, defaults to RUB

Limitations

The project is proprietary: base connectors are open, while reconciliation, forecasting and 1C or Kontur integration need a paid Pro license via YooKassa. It only deploys into the client's own Yandex Cloud through Terraform; there is no hosted service. Only Tochka and MoySklad are connected so far. Tokens stay in the client's Lockbox, but setting up Terraform, IAM roles and triggers itself needs engineering skill.

How to disable. Run terraform destroy in the infra directory and remove the MCP server from your client config.

FAQ

Does the developer see my financial data?

No, per the README the server deploys into the client's own cloud, tokens live in their Lockbox, and the Pro license is verified offline with no telemetry or call-home.

Can I try it without real tokens?

Yes, the mcp function offers a demo mode on a frozen fixture via the /demo endpoint, no real keys needed.

Discussion

No questions or reviews yet.

Tochka Bank MCP server

mcp-server-tochka-bank

Russian stack

A Tochka Bank MCP server for business owners: balance, invoices, payments with a signing link, closing documents and payment tracking

MCP serverBroad access
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38Repository stars

Tochka Bank MCP server

MCP-сервер Точка Банка

Official

Tochka Bank's official MCP: an agent checks accounts and balances, builds statements and drafts payments that you sign in online banking

MCP serverBroad access
Russian stack

An MCP server for Tochka Bank's live business API: accounts, statements, and drafting rouble payments that a human signs via SMS in online banking

MCP serverBroad access2Repository stars

Yandex Cloud Billing MCP

yandex-cloud-mcp-billing

Russian stack

Yandex Cloud spend MCP: cost breakdowns by service, folder and resource label, with conversion to any currency

MCP serverExtended access1Repository stars
Russian stack

A MoySklad MCP server with two write gates: stock, profit, reports and draft documents over JSON API 1.2

MCP serverBroad access

README in short

The README describes a neutral, self-hosted financial-context MCP server for Russian SMBs on Yandex Cloud Functions, API Gateway, YDB and Lockbox. It states the trust model: the client deploys the server themselves, tokens never leave their cloud, and the code is open to audit. Monetization is described as a proprietary product with open base connectors and a paid Pro license via YooKassa. Links point to docs/DEPLOY.md for roles and resources and docs/SETUP.md for every environment variable.

README badge

Report a problem