Tebiz Data API: FNS financials and 44-FZ procurement
Tebiz Data API
Tebiz's official remote MCP server for FNS financial statements by INN and 44-FZ procurement contracts by OKPD2, plus REST examples in Python and Node.js
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only reads public financial and procurement data; it changes nothing and files nothing on the user's behalf
- The demo token is published in plain text; production use needs your own token
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/tebiz-data-apiDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Assembled automatically, review before installing.
Run in a terminal
claude mcp add --transport http 'Tebiz Data API' https://api.tebiz.ru/v1 --header 'Authorization: Bearer <your TEBIZ_TOKEN>'Or add to the file .mcp.json, in the project
{
"mcpServers": {
"Tebiz Data API": {
"type": "http",
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"Tebiz Data API": {
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_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
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Run in a terminal
code --add-mcp '{"name":"Tebiz Data API","type":"http","url":"https://api.tebiz.ru/v1","headers":{"Authorization":"Bearer <your TEBIZ_TOKEN>"}}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"Tebiz Data API": {
"type": "http",
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_TOKEN>"
}
}
}
}If the file already exists, add the server inside the servers key.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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 ~/.codex/config.toml, for all projects
[mcp_servers."Tebiz Data API"]
url = "https://api.tebiz.ru/v1"
http_headers = { Authorization = "Bearer <your TEBIZ_TOKEN>" }If the file already exists, append the block to the end.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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 ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"Tebiz Data API": {
"httpUrl": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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": {
"Tebiz Data API": {
"serverUrl": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_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
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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": {
"Tebiz Data API": {
"type": "streamableHttp",
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_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
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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": {
"Tebiz Data API": {
"type": "streamable-http",
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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": {
"Tebiz Data API": {
"type": "remote",
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcp key.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
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": {
"Tebiz Data API": {
"url": "https://api.tebiz.ru/v1",
"headers": {
"Authorization": "Bearer <your TEBIZ_TOKEN>"
}
}
}
}If the file already exists, add the server inside the context_servers key.
Keys and settings
TEBIZ_TOKENsecret, optional- API token for Tebiz Data API
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add the mcpServers section from the repository's mcp/claude_desktop_config.json to your claude_desktop_config.json, fill in your token or the demo token from .env.example, restart Claude Desktop, and query company data by INN or procurement by OKPD2 through the query tool.
Other ways from the author
git clone https://github.com/TG-info/tebiz-api-examples && cd tebiz-api-examples && pip install requests python-dotenv && python datasets/financials/python/get_by_inn.pyQuick REST API start in Python, the demo token is already embedded in the example.
This is third-party code. Review the repository files before installing.
What it does
The repository offers two entry points to the same data. The api.tebiz.ru REST API returns Russian companies' FNS financial statements (revenue, profit, assets by year, filtered by INN) and 44-FZ procurement contracts (filtered by OKPD2 code), with cursor pagination, a 240 requests-per-minute limit and a monthly row quota. The MCP server at https://api.tebiz.ru/mcp/ connects through the mcp-remote bridge and gives the agent three tools: list_resources for the dataset list, describe_resource for a dataset's columns and filters, and query for the actual request with filters. The examples already embed a demo token limited to about fifty large companies and five OKPD2 codes; a full token covering 15 million companies is issued on the site.
Who it is for. For financial analysts, government-sector sales people and developers who need FNS financial statements and procurement data right in an agent chat or their own script.
Good fit when
- You need a quick look at a Russian company's revenue, profit and assets by INN across several years
- You need to find 44-FZ contracts by OKPD2 code: suppliers, customers, amounts
- You need an MCP tool the agent calls itself during the conversation, without writing code
Not a fit when
- You need all 15 million companies and full data depth: the demo token is limited to about fifty companies and five OKPD2 codes
- You need data outside FNS financial statements and 44-FZ procurement: no other datasets are in the examples
- You need more than 240 requests per minute or more rows per month than the demo token allows
Example request
Show me Tatneft's revenue and profit by INN 1644003838 for the last four yearsLimitations
The demo token is embedded in plain text in the README and example code, limited to a demo dataset and not meant for production. Full access and its limits are paid, with exact pricing not stated in the README, only a link to the site. The MCP server is remote and runs through api.tebiz.ru; if the site is unavailable the tools stop responding.
How to disable. Remove the fssp block from mcpServers in your client config, and for the REST examples just delete the local repository copy.
MCP
- Transport
- http
- Authentication
- API key
| Environment variables | |
|---|---|
| TEBIZ_TOKEN required, secret | Access token for the Tebiz API; a demo token is embedded in the examples, a full one is issued at api.tebiz.ru. |
Security check
- Only reads public financial and procurement data; it changes nothing and files nothing on the user's behalf
- The demo token is published in plain text; production use needs your own token
README in short
The bilingual README describes Tebiz's REST API and MCP server for Russian company data: FNS financial statements by INN and 44-FZ procurement by OKPD2. It covers the filter and operator syntax, cursor pagination, error codes, rate limits and row quota, the embedded demo token, a pointer to a separate MCP setup guide, and a template for adding a new dataset. MIT license.
FAQ
Do I need to install anything for the MCP server?
Only Node.js: the client connects to the remote server through the mcp-remote bridge, which runs automatically via npx.
What's visible with the demo token?
A limited demo slice: about fifty large companies for financials and five OKPD2 codes for procurement, listed in full in DEMO_DATA.md.
Related
A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language
inn-check-ru: counterparty risk traffic light
inn-check-ru
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