MCP.Market

mcp-egrul MCP server

by atomno-mcp·io.github.atomno-mcp/mcp-egrul·v0.1.10·1 stars
No reviews yet

EGRUL/EGRIP company registry lookup for Russian legal entities and entrepreneurs.

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

1 stars37 downloads/wk

Reviews

Write one

Nobody has reviewed mcp-egrul yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

mcp-egrul tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • bulk_cards

    Массовая выгрузка до 100 карточек за один вызов.

  • get_director

    Текущий руководитель юр.лица по ИНН (только 10-значный ИНН).

  • get_founders

    Учредители юр.лица по ИНН (только 10-значный ИНН).

  • get_full_card

    Полная карточка (все секции: реквизиты, ОКВЭД, учредители, директор).

  • ping

    Диагностика: сервер жив, сообщает версию и размер локального слепка.

  • search_by_inn

    Карточка юр.лица или ИП по ИНН (10 цифр — ООО/АО, 12 — ИП/физлицо).

  • search_by_name

    Fuzzy-поиск юр.лиц по названию через FTS5.

  • search_by_ogrn

    Карточка по ОГРН (13 цифр) или ОГРНИП (15 цифр).

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan29 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 24 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How mcp-egrul compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 63% of 48,243 servers
Tools
8
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,706 servers
Downloads a week
37
more than 26% of 12,306 servers with a package

What its tools let an agent do: 8 read

Install mcp-egrul in Claude Code, Cursor or VS Code

claude mcp add mcp-egrul -- uvx atomno-mcp-egrul
Add to Cursor

What the publisher says

From the mcp-egrul repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.atomno-mcp/mcp-egrul -->

mcp-egrul

MCP-сервер ЕГРЮЛ и ЕГРИП: реквизиты российских компаний и ИП по открытым данным налоговой службы. Можно поставить у себя или подключить к Cursor, Claude и любому клиенту MCP.

Russian company registry lookup for AI agents.

Статус: v0.1.2 — open-версия (self-host через SQLite) полностью готова + клиентская часть hosted Pro (HTTP-клиент HostedClient для api.atomno-mcp.ru). Опубликована на PyPI, индексирована в Glama и Smithery. Сама hosted Pro-инфра — в активной разработке. Coverage 100.00% (345 тестов, ruff clean, fastmcp 3.2.4, enforced через --cov-fail-under=100).

Парный проект: mcp-fns-check (risk-чек-слой поверх ЕГРЮЛ).

Что это

Семь MCP-тулзов, видимых AI-ассистенту (Cursor, Claude Desktop, Cline, любой MCP-клиент):

Плюс диагностический ping для проверки что сервер жив.

Полная спецификация payload'ов — в src/mcp_egrul/schemas.py (Pydantic-модели CompanyCard, IECard, SearchResult, BulkResult).

Установка

Вариант 1 — через PyPI (рекомендуется для пользователей)

# Без локального clone — работает «из коробки»
uvx atomno-mcp-egrul

# Или установка глобально
pipx install atomno-mcp-egrul
atomno-mcp-egrul

# Или классический pip в venv
pip install atomno-mcp-egrul
atomno-mcp-egrul

Вариант 2 — dev-режим (для разработчиков)

Требуется Python 3.11+ и uv (быстрая замена pip, опционально).

git clone https://github.com/atomno-mcp/mcp-egrul
cd mcp-egrul
uv venv
uv pip install -e ".[dev]"

Альтернативно через pip:

python -m venv .venv
.venv/Scripts/activate    # Windows
# source .venv/bin/activate  # Linux/macOS
pip install -e ".[dev]"

Запуск

atomno-mcp-egrul

Транспорт по умолчанию — stdio (стандартный ввод/вывод JSON-RPC). Подходит для подключения к Cursor / Claude Desktop / Claude Code.

Claude Desktop (claudedesktopconfig.json)

{
  "mcpServers": {
    "egrul": {
      "command": "uvx",
      "args": ["atomno-mcp-egrul"]
    }
  }
}

Cursor (.cursor/mcp.json в проекте или ~/.cursor/mcp.json глобально)

{
  "mcpServers": {
    "egrul": {
      "command": "uvx",
      "args": ["atomno-mcp-egrul"]
    }
  }
}

Если не используете uv, замените "command": "uvx", "args": ["atomno-mcp-egrul"] на "command": "atomno-mcp-egrul" (требует pip install atomno-mcp-egrul или pipx install atomno-mcp-egrul).

Docker (self-host) — quick start

# 1. Скачайте дампы ФНС (acceptance на сайте ФНС — раз в жизни).
#    Источники:
#      ЕГРЮЛ — https://www.nalog.gov.ru/opendata/7707329152-egrul/
#      ЕГРИП — https://www.nalog.gov.ru/opendata/7707329152-egrip/
#    Положите их в структуру:
mkdir -p dumps/egrul/2026-04-24 dumps/egrip/2026-04-24
cp ~/Downloads/EGRUL_*.zip dumps/egrul/2026-04-24/
cp ~/Downloads/EGRIP_*.zip dumps/egrip/2026-04-24/

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

mcp-egrul: common questions

Is mcp-egrul MCP server safe?
Mostly: it is graded B (82/100). Read the mcp-egrul safety report
How do I install mcp-egrul?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does mcp-egrul need an API key?
Yes. The registry entry asks for ATOMNO_API_KEY.
Is mcp-egrul maintained?
The last commit was 65 days ago (2026-09-01). The latest release is v0.1.10.
How does mcp-egrul compare with other MCP servers?
safety score 82/100 (higher than 63% of 48,243 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from atomno-mcp →