@metarebalance/dadata-mcp
31 инструмент вместо ~4 у официального DaData MCP. Полное покрытие DaData API — адреса, компании, банки, телефоны, email, паспорта, автомобили, геокодирование и 12 справочников. Локальная установка через npx, без внешнего хостинга. Часть серии Russian API MCP (47 серверов) by @theYahia.

English version (README.en.md)
Почему этот, а не официальный MCP от DaData?
У DaData есть официальный MCP-сервер с 4 инструментами. Наш пакет покрывает весь API:
| Официальный MCP | @metarebalance/dadata-mcp |
|---|
| Инструменты | 4 | 31 |
| Ресурсы | 0 | 2 |
| Промпты | 0 | 2 |
| Транспорт | Удалённый | Локальный stdio |
| Бесплатные | 1 | 23 |
| npm-пакет | Нет | Да |
Быстрый старт
Claude Desktop
Добавьте в claude_desktop_config.json:
{
"mcpServers": {
"dadata": {
"command": "npx",
"args": ["-y", "@metarebalance/dadata-mcp"],
"env": {
"DADATA_API_KEY": "ваш-api-ключ",
"DADATA_SECRET_KEY": "ваш-секретный-ключ"
}
}
}
}
Claude Code
claude mcp add dadata -- npx -y @metarebalance/dadata-mcp
VS Code / Cursor
Добавьте в .vscode/mcp.json:
{
"servers": {
"dadata": {
"command": "npx",
"args": ["-y", "@metarebalance/dadata-mcp"],
"env": {
"DADATA_API_KEY": "ваш-api-ключ",
"DADATA_SECRET_KEY": "ваш-секретный-ключ"
}
}
}
}
Windsurf
Добавьте в настройки MCP Toolkit:
{
"mcpServers": {
"dadata": {
"command": "npx",
"args": ["-y", "@metarebalance/dadata-mcp"],
"env": {
"DADATA_API_KEY": "ваш-api-ключ",
"DADATA_SECRET_KEY": "ваш-секретный-ключ"
}
}
}
}
Инструменты (31)
Адреса (3)
| Инструмент | Стоимость | Описание |
|---|
suggest_address | Бесплатно | Автодополнение адресов с индексом, ФИАС, координатами, часовым поясом |
clean_address | 0.20 ₽ | Стандартизация адреса в 80+ полей с кодами качества |
find_by_id_address | Бесплатно | Адрес по коду ФИАС, КЛАДР или кадастровому номеру |
Компании (8)
| Инструмент | Стоимость | Описание |
|---|
suggest_company | Бесплатно | Поиск по названию, ИНН или ОГРН |
find_company_by_id | Бесплатно | Информация о компании по ИНН. Базовые данные бесплатно; финансы и все коды ОКВЭД — только тариф «Максимальный» |
find_affiliated | Максимальный | Аффилированные компании по ИНН. Не работает на бесплатном тарифе |
find_company_by_email | 7 ₽ | Компания по корпоративному email или домену |
find_brand | 7 ₽ | Бренд, сайт и логотип по ИНН |
find_self_employed | Бесплатно | Проверка самозанятого по ИНН (через ФНС) |
suggest_company_by | Бесплатно | Компании Беларуси по названию или УНП |
suggest_company_kz | Бесплатно | Компании Казахстана по названию или БИН |
Банки (1)
| Инструмент | Стоимость | Описание |
|---|
find_bank | Бесплатно | Поиск по БИК, SWIFT, ИНН, рег. номеру или названию |
ФИО (2)
| Инструмент | Стоимость | Описание |
|---|
suggest_fio | Бесплатно | Автодополнение ФИО с определением пола |
clean_name | 0.20 ₽ | Разбор ФИО, определение пола, склонение по падежам |
Контакты (3)
| Инструмент | Стоимость | Описание |
|---|
clean_phone | 0.20 ₽ | Проверка телефона: оператор, регион, часовой пояс |
clean_email | 0.20 ₽ | Проверка email: исправление опечаток, одноразовый/корпоративный/личный |
suggest_email | Бесплатно | Автодополнение email с подсказкой доменов |
Паспорта (3)
| Инструмент | Стоимость | Описание |
|---|
clean_passport | 0.20 ₽ | Проверка по реестру недействительных паспортов МВД |
find_fms_unit | Бесплатно | Кем выдан паспорт по коду подразделения |
find_inn_by_passport | Бесплатно | ИНН по паспортным данным и дате рождения (через ФНС) |
Автомобили (2)
| Инструмент | Стоимость | Описание |
|---|
clean_vehicle | 0.20 ₽ | Распознавание марки и модели из строки |
suggest_car_brand | Бесплатно | Автодополнение марок автомобилей |
Геолокация (2)
| Инструмент | Стоимость | Описание |
|---|
geolocate_address | Бесплатно | Обратное геокодирование: адрес по координатам |
ip_locate | Бесплатно | Город по IP-адресу |
Почта и страны (2)
| Инструмент | Стоимость | Описание |
|---|
find_postal_unit | Бесплатно | Почтовое отделение по индексу или координатам |
suggest_country | Бесплатно | Справочник стран (ISO 3166) |
Логистика (1)
| Инструмент | Стоимость | Описание |
|---|
find_delivery_city | Бесплатно | ID города в СДЭК, Boxberry, DPD по коду КЛАДР |
Композитная проверка (1)
| Инструмент | Стоимость | Описание |
|---|
clean_person | 0.20 ₽ | Проверка записи о человеке одним запросом: ФИО + адрес + телефон + email + паспорт. В 5-8 раз дешевле раздельных запросов |
Справочники (1 инструмент, 12 справочников)
| Инструмент | Стоимость | Описание |
|---|
lookup_reference | Бесплатно | ОКВЭД 2, ОКПД 2, ОКТМО, станции метро, налоговые (ФНС), таможни (ФТС), суды, валюты (ISO 4217), МКТУ, профессии, должности, медицинские должности |
Личный кабинет (2)
| Инструмент | Стоимость | Описание |
|---|
get_balance | Бесплатно | Баланс и статистика использования за день |
get_versions | Бесплатно | Даты обновления справочников |
Ресурсы
dadata://reference/quality-codes — Расшифровка кодов качества DaData (qc, qc_geo) и уровней достоверности
dadata://reference/capabilities — Возможности API: бесплатные/платные функции, лимиты
Промпты
check_counterparty — Проверка контрагента по ИНН: статус, руководитель, финансы, оценка риска
validate_address — Пошаговая валидация адреса с оценкой качества
Переменные окружения
| Переменная | Обязательна | Описание |
|---|
DADATA_API_KEY | Да | API-ключ — зарегистрируйтесь бесплатно и получите в личном кабинете |
DADATA_SECRET_KEY | Нет | Секретный ключ для платных инструментов (clean_*). Без него работают 23 бесплатных |
Тарифы и лимиты
Подробнее: dadata.ru/pricing
- Бесплатный тариф: до 10 000 запросов в сутки. Достаточно для разработки и небольших проектов.
- Тариф «Максимальный» необходим для:
find_affiliated — поиск аффилированных компаний (не работает на бесплатном тарифе)
find_company_by_id — полные данные (финансы, все коды ОКВЭД приходят только на «Максимальном»; базовая информация доступна бесплатно)
- Платные инструменты (
clean_*) — от 0.20 ₽ за запрос, требуют DADATA_SECRET_KEY
Примеры запросов
Найди компанию по ИНН 7707083893
Стандартизируй адрес: мск сухонская 11 кв 89
Проверь контрагента с ИНН 7736207543 — компания действует?
Какой город у IP 46.226.227.20?
Найди БИК и корсчёт Сбербанка
Проверь паспорт 4510 235857 — есть в реестре недействительных?
Найди ОКВЭД для «разработка программного обеспечения»
Безопасность
- API-ключи никогда не логируются и не попадают в ответы об ошибках
- Все входные данные валидируются через Zod-схемы
- Защита от path traversal при построении эндпоинтов
- Жёсткий таймаут 10 секунд на все HTTP-запросы
- Повторные попытки с экспоненциальным backoff только на временные ошибки (429, 5xx)
stdout зарезервирован для JSON-RPC — логи идут в stderr
Разработка
git clone https://github.com/theYahia/dadata-mcp.git
cd dadata-mcp
npm install
npm run build
npm test
Тест через MCP Inspector
DADATA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js
Откроется интерактивный UI на http://localhost:6274 для вызова инструментов и просмотра JSON-RPC сообщений.
Часть серии Russian API MCP
Этот сервер — часть открытой серии MCP-серверов для российских API:
| MCP | Статус | Описание |
|---|
| @metarebalance/dadata-mcp | ✅ готов | Адреса, компании, банки, телефоны |
| @theyahia/cbr-mcp | 📅 скоро | Курсы валют, ключевая ставка |
| @theyahia/yookassa-mcp | 📅 скоро | Платежи, возвраты, чеки 54-ФЗ |
| @theyahia/moysklad-mcp | 📅 скоро | Склад, заказы, контрагенты |
| @theyahia/cdek-mcp | 📅 скоро | Расчёт, создание, трекинг |
| @theyahia/ozon-mcp | 📅 скоро | Товары, цены, аналитика |
| @theyahia/amocrm-mcp | 📅 скоро | Сделки, контакты, воронки |
| ... | 📅 | +43 сервера — полный список на витрине |
50 MCP-серверов для российских API: github.com/theYahia/russian-mcp
Лицензия
MIT