mcp-egrul
EGRUL and EGRIP MCP server: company and sole proprietor details, director and founders from Federal Tax Service open data, self-hosted
Install
uvx atomno-mcp-egrulAlso pipx install atomno-mcp-egrul or pip install atomno-mcp-egrul.
This is third-party code. Review the repository files before installing.
What it does
The server looks up Russian companies and sole proprietors by INN, OGRN or name and returns a card with status, address, director and founders with shares. Bulk checks handle up to 100 INNs per call, and identifier check digits are validated before querying. In open mode data comes from a local SQLite database filled by importing manually downloaded Federal Tax Service dumps, with a daily scheduled refresh. With ATOMNO_API_KEY set, requests go to the author's paid hosted API.
Who it is for. Lawyers, accountants, sales teams and developers who vet counterparties against the state registry.
Good fit when
- You need company status and director by INN
- You need to check a batch of counterparties
- You want your own registry snapshot without paid APIs
Not a fit when
- You need same-day data while the local dump lags
- You lack disk space and time to import the full registry snapshot
Example request
Check these INNs in EGRUL: who is the director, who are the founders, and are any liquidatedLimitations
The database is empty until you import: tax service dumps are about 15 GB, downloaded manually after accepting the license on the FNS site, and the first import takes up to an hour. Data lags the registry by the dump publication delay. The hosted Pro mode is paid, and some of its features are still in development.
How to disable. Remove the egrul block from your MCP client config. Stop the Docker version with docker compose down; the mcp_egrul_data.sqlite file can be removed manually.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| MCP_EGRUL_DB | Path to the SQLite registry snapshot |
| MCP_EGRUL_DUMPS_DIR | Folder with FNS dumps |
| ATOMNO_API_KEY secret | Key for the paid hosted mode |
Security check
- Stores and processes registry data including names of directors and founders
- With a key set, sends queries to the author's external service
README in short
The Russian README lists seven tools and install options via uvx, pipx or pip, with Claude Desktop and Cursor configs. It details a Docker setup with FNS dump import and a scheduler that picks up new archives nightly. It covers import exit codes, environment variables and the paid hosted mode, which never silently falls back to stale data. The author emphasizes full test coverage. MIT license.
FAQ
Why doesn't the server download dumps itself?
FNS archives require accepting a license on the tax service site, so the author leaves downloading to the user.
Do I need a key?
Not for the local database. ATOMNO_API_KEY is only for the paid hosted mode.
Related
166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases
Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml
Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment
A token-lean MCP server for PostgreSQL, MySQL, MariaDB, SQL Server and SQLite with a read-only mode