{
  "markdown": "# MCP-сервер для DaData — подсказки адресов, проверка компаний по ИНН и очистка данных через ИИ\n\nЕсли вы искали, как подключить DaData к нейросети, пробить контрагента по ИНН, разобрать адрес на составные части или почистить базу телефонов и email — это оно. **31 инструмент вместо ~4 у [официального DaData MCP](https://dadata.ru/mcp/)**: адреса, компании, банки, телефоны, паспорта, автомобили, геокодирование и 12 справочников, из них 23 метода бесплатны. Ставится локально через `npx`, без внешнего хостинга — ключ остаётся у вас. Часть серии [WWmcp](https://github.com/theYahia/WWmcp) (46 серверов) by [@theYahia](https://github.com/theYahia).\n\n[![npm](https://img.shields.io/npm/v/@metarebalance/dadata-mcp)](https://www.npmjs.com/package/@metarebalance/dadata-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> **[English version (README.en.md)](./README.en.md)**\n\n## Почему этот, а не официальный MCP от DaData?\n\nУ DaData есть [официальный MCP-сервер](https://dadata.ru/mcp) с 4 инструментами. Наш пакет покрывает **весь API**:\n\n| | Официальный MCP | @metarebalance/dadata-mcp |\n|---------|:-----------:|:---------------------:|\n| Инструменты | 4 | **31** |\n| Ресурсы | 0 | **2** |\n| Промпты | 0 | **2** |\n| Транспорт | Удалённый | **Локальный stdio** |\n| Бесплатные | 1 | **23** |\n| npm-пакет | Нет | **Да** |\n\n## Быстрый старт\n\n### Claude Desktop\n\nДобавьте в `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"dadata\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@metarebalance/dadata-mcp\"],\n      \"env\": {\n        \"DADATA_API_KEY\": \"ваш-api-ключ\",\n        \"DADATA_SECRET_KEY\": \"ваш-секретный-ключ\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add dadata -- npx -y @metarebalance/dadata-mcp\n```\n\n### VS Code / Cursor\n\nДобавьте в `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"dadata\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@metarebalance/dadata-mcp\"],\n      \"env\": {\n        \"DADATA_API_KEY\": \"ваш-api-ключ\",\n        \"DADATA_SECRET_KEY\": \"ваш-секретный-ключ\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nДобавьте в настройки MCP Toolkit:\n\n```json\n{\n  \"mcpServers\": {\n    \"dadata\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@metarebalance/dadata-mcp\"],\n      \"env\": {\n        \"DADATA_API_KEY\": \"ваш-api-ключ\",\n        \"DADATA_SECRET_KEY\": \"ваш-секретный-ключ\"\n      }\n    }\n  }\n}\n```\n\n## Инструменты (31)\n\n### Адреса (3)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `suggest_address` | Бесплатно | Автодополнение адресов с индексом, ФИАС, координатами, часовым поясом |\n| `clean_address` | 0.20 ₽ | Стандартизация адреса в 80+ полей с кодами качества |\n| `find_by_id_address` | Бесплатно | Адрес по коду ФИАС, КЛАДР или кадастровому номеру |\n\n### Компании (8)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `suggest_company` | Бесплатно | Поиск по названию, ИНН или ОГРН |\n| `find_company_by_id` | Бесплатно | Информация о компании по ИНН. Базовые данные бесплатно; **финансы и все коды ОКВЭД** — только тариф [«Максимальный»](https://dadata.ru/pricing/?product=suggestions) |\n| `find_affiliated` | **Максимальный** | Аффилированные компании по ИНН. **Не работает на бесплатном тарифе** |\n| `find_company_by_email` | 7 ₽ | Компания по корпоративному email или домену |\n| `find_brand` | 7 ₽ | Бренд, сайт и логотип по ИНН |\n| `find_self_employed` | Бесплатно | Проверка самозанятого по ИНН (через ФНС) |\n| `suggest_company_by` | Бесплатно | Компании Беларуси по названию или УНП |\n| `suggest_company_kz` | Бесплатно | Компании Казахстана по названию или БИН |\n\n### Банки (1)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `find_bank` | Бесплатно | Поиск по БИК, SWIFT, ИНН, рег. номеру или названию |\n\n### ФИО (2)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `suggest_fio` | Бесплатно | Автодополнение ФИО с определением пола |\n| `clean_name` | 0.20 ₽ | Разбор ФИО, определение пола, склонение по падежам |\n\n### Контакты (3)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `clean_phone` | 0.20 ₽ | Проверка телефона: оператор, регион, часовой пояс |\n| `clean_email` | 0.20 ₽ | Проверка email: исправление опечаток, одноразовый/корпоративный/личный |\n| `suggest_email` | Бесплатно | Автодополнение email с подсказкой доменов |\n\n### Паспорта (3)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `clean_passport` | 0.20 ₽ | Проверка по реестру недействительных паспортов МВД |\n| `find_fms_unit` | Бесплатно | Кем выдан паспорт по коду подразделения |\n| `find_inn_by_passport` | Бесплатно | ИНН по паспортным данным и дате рождения (через ФНС) |\n\n### Автомобили (2)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `clean_vehicle` | 0.20 ₽ | Распознавание марки и модели из строки |\n| `suggest_car_brand` | Бесплатно | Автодополнение марок автомобилей |\n\n### Геолокация (2)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `geolocate_address` | Бесплатно | Обратное геокодирование: адрес по координатам |\n| `ip_locate` | Бесплатно | Город по IP-адресу |\n\n### Почта и страны (2)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `find_postal_unit` | Бесплатно | Почтовое отделение по индексу или координатам |\n| `suggest_country` | Бесплатно | Справочник стран (ISO 3166) |\n\n### Логистика (1)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `find_delivery_city` | Бесплатно | ID города в СДЭК, Boxberry, DPD по коду КЛАДР |\n\n### Композитная проверка (1)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `clean_person` | 0.20 ₽ | Проверка записи о человеке одним запросом: ФИО + адрес + телефон + email + паспорт. В 5-8 раз дешевле раздельных запросов |\n\n### Справочники (1 инструмент, 12 справочников)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `lookup_reference` | Бесплатно | ОКВЭД 2, ОКПД 2, ОКТМО, станции метро, налоговые (ФНС), таможни (ФТС), суды, валюты (ISO 4217), МКТУ, профессии, должности, медицинские должности |\n\n### Личный кабинет (2)\n\n| Инструмент | Стоимость | Описание |\n|------------|:---------:|----------|\n| `get_balance` | Бесплатно | Баланс и статистика использования за день |\n| `get_versions` | Бесплатно | Даты обновления справочников |\n\n## Ресурсы\n\n- **`dadata://reference/quality-codes`** — Расшифровка кодов качества DaData (qc, qc_geo) и уровней достоверности\n- **`dadata://reference/capabilities`** — Возможности API: бесплатные/платные функции, лимиты\n\n## Промпты\n\n- **`check_counterparty`** — Проверка контрагента по ИНН: статус, руководитель, финансы, оценка риска\n- **`validate_address`** — Пошаговая валидация адреса с оценкой качества\n\n## Переменные окружения\n\n| Переменная | Обязательна | Описание |\n|------------|:----------:|----------|\n| `DADATA_API_KEY` | Да | API-ключ — [зарегистрируйтесь бесплатно](https://dadata.ru/?ref=255717) и получите в [личном кабинете](https://dadata.ru/profile/#info) |\n| `DADATA_SECRET_KEY` | Нет | Секретный ключ для платных инструментов (`clean_*`). Без него работают 23 бесплатных |\n\n## Тарифы и лимиты\n\n> Подробнее: [dadata.ru/pricing](https://dadata.ru/pricing/?product=suggestions)\n\n- **Бесплатный тариф:** до **10 000 запросов в сутки**. Достаточно для разработки и небольших проектов.\n- **Тариф «Максимальный»** необходим для:\n  - `find_affiliated` — поиск аффилированных компаний (**не работает** на бесплатном тарифе)\n  - `find_company_by_id` — полные данные (финансы, все коды ОКВЭД приходят **только** на «Максимальном»; базовая информация доступна бесплатно)\n- Платные инструменты (`clean_*`) — от 0.20 ₽ за запрос, требуют `DADATA_SECRET_KEY`\n\n## Примеры запросов\n\n```\nНайди компанию по ИНН 7707083893\n```\n\n```\nСтандартизируй адрес: мск сухонская 11 кв 89\n```\n\n```\nПроверь контрагента с ИНН 7736207543 — компания действует?\n```\n\n```\nКакой город у IP 46.226.227.20?\n```\n\n```\nНайди БИК и корсчёт Сбербанка\n```\n\n```\nПроверь паспорт 4510 235857 — есть в реестре недействительных?\n```\n\n```\nНайди ОКВЭД для «разработка программного обеспечения»\n```\n\n## Безопасность\n\n- API-ключи никогда не логируются и не попадают в ответы об ошибках\n- Все входные данные валидируются через Zod-схемы\n- Защита от path traversal при построении эндпоинтов\n- Жёсткий таймаут 10 секунд на все HTTP-запросы\n- Повторные попытки с экспоненциальным backoff только на временные ошибки (429, 5xx)\n- `stdout` зарезервирован для JSON-RPC — логи идут в `stderr`\n\n## Разработка\n\n```bash\ngit clone https://github.com/theYahia/dadata-mcp.git\ncd dadata-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n### Тест через MCP Inspector\n\n```bash\nDADATA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js\n```\n\nОткроется интерактивный UI на `http://localhost:6274` для вызова инструментов и просмотра JSON-RPC сообщений.\n\n## Часть серии WWmcp\n\nЭтот сервер — часть открытой серии MCP-серверов для российских API:\n\n| MCP | Статус | Описание |\n|-----|--------|----------|\n| [@metarebalance/dadata-mcp](https://github.com/theYahia/dadata-mcp) | ✅ готов | Адреса, компании, банки, телефоны |\n| @theyahia/cbr-mcp | 📅 скоро | Курсы валют, ключевая ставка |\n| @theyahia/yookassa-mcp | 📅 скоро | Платежи, возвраты, чеки 54-ФЗ |\n| @theyahia/moysklad-mcp | 📅 скоро | Склад, заказы, контрагенты |\n| @theyahia/cdek-mcp | 📅 скоро | Расчёт, создание, трекинг |\n| @theyahia/ozon-mcp | 📅 скоро | Товары, цены, аналитика |\n| @theyahia/amocrm-mcp | 📅 скоро | Сделки, контакты, воронки |\n| ... | 📅 | **46 серверов** — полный список на витрине |\n\n**46 MCP-серверов для российских API:** [github.com/theYahia/WWmcp](https://github.com/theYahia/WWmcp)\n\n## Лицензия\n\nMIT\n\n---\n\nЧасть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)\n",
  "bytes": 9903,
  "sha": "94ecdaf66a8e21dff7db43f4fd7769ff2cf86ebd1a707aa377d1fba3a690208a",
  "repo_slug": "theyahia/dadata-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_dadata_mcp_112f870a/readme"
}