Tochka Bank MCP server

mcp-server-tochka-bank

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

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Can issue invoices and create payments with signing links, and acquiring operations move money immediately
  • The JWT token can be issued with broad permissions by default, so it is worth scoping it to only what is needed
All reasons and checks
Russian stack

dontsovcmc/mcp-server-tochka-bank

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mcp-server-tochka-bank

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'TOCHKA_TOKEN=<your TOCHKA_TOKEN>' tochka-bank -- uvx mcp-server-tochka-bank==0.6.0

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"tochka-bank","type":"stdio","command":"uvx","args":["mcp-server-tochka-bank==0.6.0"],"env":{"TOCHKA_TOKEN":"<your TOCHKA_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "tochka-bank": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add tochka-bank --env 'TOCHKA_TOKEN=<your TOCHKA_TOKEN>' -- uvx mcp-server-tochka-bank==0.6.0

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.tochka-bank]
command = "uvx"
args = ["mcp-server-tochka-bank==0.6.0"]
env = { TOCHKA_TOKEN = "<your TOCHKA_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -e 'TOCHKA_TOKEN=<your TOCHKA_TOKEN>' tochka-bank uvx mcp-server-tochka-bank==0.6.0

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "tochka-bank": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-server-tochka-bank==0.6.0"
      ],
      "environment": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "tochka-bank": {
      "command": "uvx",
      "args": [
        "mcp-server-tochka-bank==0.6.0"
      ],
      "env": {
        "TOCHKA_TOKEN": "<your TOCHKA_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

TOCHKA_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 25, 2026, commit 7803f18.

Text for your agent

Create a JWT token in Tochka online banking under Settings, Integrations and API, choose the needed permissions, then connect the server with claude mcp add tochka-bank -e TOCHKA_TOKEN=ваш_токен -- uvx mcp-server-tochka-bank.

Other ways from the author
claude mcp add tochka-bank -e TOCHKA_TOKEN=ваш_токен -- uvx mcp-server-tochka-bank

The uvx method without installing the package, from the README.

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

What it does

The server works with the Tochka Bank API using a JWT token from the online banking dashboard and covers more than thirty operations: account balances and details, statements and card transactions, transaction and counterparty lookup by tax ID, monthly incoming payments for tax reporting, invoice issuing and PDF download, closing document creation, payments and acquiring with capture, refund and fiscal receipts, recurring subscriptions, and API consent management. Creating a payment does not move money directly but returns a link to sign it in the bank. There is also a local invoice-payment tracker that checks status via the Tochka API or a statement and stores data locally in a file, plus a local goods catalog for quick invoicing. The package works both as an MCP server and as a CLI with JSON output.

Who it is for. For business owners and accountants banking with Tochka who want to manage balance, invoices and payments through an agent.

Good fit when

  • You want a quick balance check or to find a counterparty's bank details by tax ID
  • You need to issue an invoice, create a closing document, or track when an invoice gets paid
  • You need a report of monthly incoming payments by payer for tax purposes

Not a fit when

  • You do not have access to Tochka online banking to create a JWT token
  • You do not want to grant an agent payment and acquiring permissions: the token can be scoped to balance and statement reads only

Example request

Show my Tochka account balance and issue an invoice for 45000 rubles to a customer

Limitations

The project has a single author with no official affiliation with Tochka Bank. Outgoing payments and closing documents are created with a link to sign, not charged automatically, but acquiring capture and refund operations move funds immediately. The local payment tracker stores invoice data in an unencrypted JSON file on the user's disk.

How to disable. Remove the tochka-bank server from your MCP client config with claude mcp remove tochka-bank and revoke the JWT token in Tochka online banking.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
TOCHKA_TOKEN
required, secret
JWT token from Tochka online banking with the chosen permissions.

Security check

  • Can issue invoices and create payments with signing links, and acquiring operations move money immediately
  • The JWT token can be issued with broad permissions by default, so it is worth scoping it to only what is needed

README in short

The Russian README groups more than thirty tools into sections: banking operations, invoices and documents, acquiring, subscriptions, API consents and payment tracking. It details the JWT token and required permissions, configs for Claude Code and Claude Desktop on macOS, Windows and Linux, and a full CLI mode with commands and examples. It states that all data stays on the user's computer.

FAQ

Can the agent withdraw money from the account on its own?

Creating a regular payment or closing document only returns a link to sign in the bank, it does not charge directly. But acquiring capture and refund operations move funds immediately if the token has that permission.

Where is the token stored?

Only on the user's computer, in an environment variable; the server never sends it anywhere except the Tochka API itself.

Editors’ pick

A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice

SkillMedium riskNo VPN needed16.6KRepository stars
Official

Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data

MCP serverHigh riskNeeds a VPN1.8KRepository stars
Official

Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language

MCP serverHigh risk995Repository stars
Editors’ pick

An open-source skill that checks a Russian company by tax ID across EGRUL, bailiffs, courts, bankruptcy and sanctions, and returns a dated risk verdict

SkillLow riskRussian stackNo VPN needed4Repository stars
Foxx AITochka Bank MCP server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.