mcp-egrul
EGRUL and EGRIP MCP server: company and sole proprietor details, director and founders from Federal Tax Service open data, self-hosted
- 1 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Stores and processes registry data including names of directors and founders
- With a key set, sends queries to the author's external service
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-egrulDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Stores and processes registry data including names of directors and founders
- With a key set, sends queries to the author's external service
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 liquidatedMCP
- 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_KEYsecret- Key for the paid hosted mode
Limitations
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.
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.
Discussion
No questions or reviews yet.
An MCP server that checks Russian counterparties by INN or OGRN: company registry, bankruptcy, tax debt, bailiffs and arbitration
KontragentPro MCP: Russian company lookup
KontragentPro MCP server
KontragentPro's official MCP that checks Russian companies by INN with no key required: EGRUL, FNS filings, bankruptcy, inspections and sanctions lists
Unofficial Checko.ru MCP server for counterparty checks: EGRUL, EGRIP, financials, court cases, state contracts and bankruptcies
NewDB MCP server for KYC and company checks
NewDB MCP Server
The official MCP server for the paid NewDB API: passports, bailiff debts, company registry, tax account holds and bankruptcy checks across Russia and the CIS
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
htmlweb.ru MCP: lookups, checks and payments
htmlweb.ru MCP Server
A remote MCP server for htmlweb.ru with dozens of methods: INN checks, geodata, calendar, validators, plus card binding and charges
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| mcp-egrul (this entry) | no | not required | 1 | |
| Devnors Data MCP | yes | API key | 656 | MCP server for the paid Devnors Data API |
| DataNewton MCP | yes | API key | DataNewton's cloud MCP server |
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.