Dadata Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.5Updated Oct 24, 2026

MCP server for DaData.ru — address validation, company lookup, geocoding. 31 tools.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant validate Russian addresses, look up companies by INN, and clean phone, email, passport and vehicle data via the DaData API.

What you can do
Wraps the DaData.ru API in 31 tools covering address suggestions and standardization, company and bank lookup by INN, OGRN, BIK or SWIFT, geocoding and reverse geocoding, IP-based city lookup, postal units, and reference directories such as OKVED, OKTMO and currencies. It also cleans personal records (name, address, phone, email, passport) and offers two resources and two prompts, including counterparty checks and step-by-step address validation.
When to use it
Useful when an assistant needs Russian or CIS address, company or contact data: checking a counterparty by INN, standardizing a messy address, resolving a phone or email, or looking up a bank by BIK. It is a good fit for CRM or data-cleaning workflows over Russian records.
Requirements
Runs locally over stdio, typically started with npx from the npm package @metarebalance/dadata-mcp, so Node.js is needed. A DaData account and the DADATA_API_KEY environment variable are required; the optional DADATA_SECRET_KEY unlocks the paid clean_* tools. Network access to the DaData API is required.
Before you install
DADATA_API_KEY and DADATA_SECRET_KEY are secrets and must be supplied via environment variables. Paid tools (clean_*) cost from about 0.20 RUB per request and require the secret key, so usage spends money on the DaData account; find_affiliated and full company financials need the paid Maximum plan. Queries send the submitted addresses, INNs, phone numbers, emails and passport data to DaData, a third party.

Installation

In SourceWeft

  1. Open Dadata Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP-сервер для DaData — подсказки адресов, проверка компаний по ИНН и очистка данных через ИИ

Если вы искали, как подключить DaData к нейросети, пробить контрагента по ИНН, разобрать адрес на составные части или почистить базу телефонов и email — это оно. 31 инструмент вместо ~4 у официального DaData MCP: адреса, компании, банки, телефоны, паспорта, автомобили, геокодирование и 12 справочников, из них 23 метода бесплатны. Ставится локально через npx, без внешнего хостинга — ключ остаётся у вас. Часть серии WWmcp (46 серверов) by @theYahia.

[npm] [License: MIT]

English version (README.en.md)

Почему этот, а не официальный MCP от DaData?

У DaData есть официальный MCP-сервер с 4 инструментами. Наш пакет покрывает весь API:

Официальный MCP@metarebalance/dadata-mcp
Инструменты431
Ресурсы02
Промпты02
ТранспортУдалённыйЛокальный stdio
Бесплатные123
npm-пакетНетДа

Быстрый старт

Claude Desktop

Добавьте в claude_desktop_config.json:

json
{  "mcpServers": {    "dadata": {      "command": "npx",      "args": ["-y", "@metarebalance/dadata-mcp"],      "env": {        "DADATA_API_KEY": "ваш-api-ключ",        "DADATA_SECRET_KEY": "ваш-секретный-ключ"      }    }  }}

Claude Code

bash
claude mcp add dadata -- npx -y @metarebalance/dadata-mcp

VS Code / Cursor

Добавьте в .vscode/mcp.json:

json
{  "servers": {    "dadata": {      "command": "npx",      "args": ["-y", "@metarebalance/dadata-mcp"],      "env": {        "DADATA_API_KEY": "ваш-api-ключ",        "DADATA_SECRET_KEY": "ваш-секретный-ключ"      }    }  }}

Windsurf

Добавьте в настройки MCP Toolkit:

json
{  "mcpServers": {    "dadata": {      "command": "npx",      "args": ["-y", "@metarebalance/dadata-mcp"],      "env": {        "DADATA_API_KEY": "ваш-api-ключ",        "DADATA_SECRET_KEY": "ваш-секретный-ключ"      }    }  }}

Инструменты (31)

Адреса (3)

ИнструментСтоимостьОписание
suggest_addressБесплатноАвтодополнение адресов с индексом, ФИАС, координатами, часовым поясом
clean_address0.20 ₽Стандартизация адреса в 80+ полей с кодами качества
find_by_id_addressБесплатноАдрес по коду ФИАС, КЛАДР или кадастровому номеру

Компании (8)

ИнструментСтоимостьОписание
suggest_companyБесплатноПоиск по названию, ИНН или ОГРН
find_company_by_idБесплатноИнформация о компании по ИНН. Базовые данные бесплатно; финансы и все коды ОКВЭД — только тариф «Максимальный»
find_affiliatedМаксимальныйАффилированные компании по ИНН. Не работает на бесплатном тарифе
find_company_by_email7 ₽Компания по корпоративному email или домену
find_brand7 ₽Бренд, сайт и логотип по ИНН
find_self_employedБесплатноПроверка самозанятого по ИНН (через ФНС)
suggest_company_byБесплатноКомпании Беларуси по названию или УНП
suggest_company_kzБесплатноКомпании Казахстана по названию или БИН

Банки (1)

ИнструментСтоимостьОписание
find_bankБесплатноПоиск по БИК, SWIFT, ИНН, рег. номеру или названию

ФИО (2)

ИнструментСтоимостьОписание
suggest_fioБесплатноАвтодополнение ФИО с определением пола
clean_name0.20 ₽Разбор ФИО, определение пола, склонение по падежам

Контакты (3)

ИнструментСтоимостьОписание
clean_phone0.20 ₽Проверка телефона: оператор, регион, часовой пояс
clean_email0.20 ₽Проверка email: исправление опечаток, одноразовый/корпоративный/личный
suggest_emailБесплатноАвтодополнение email с подсказкой доменов

Паспорта (3)

ИнструментСтоимостьОписание
clean_passport0.20 ₽Проверка по реестру недействительных паспортов МВД
find_fms_unitБесплатноКем выдан паспорт по коду подразделения
find_inn_by_passportБесплатноИНН по паспортным данным и дате рождения (через ФНС)

Автомобили (2)

ИнструментСтоимостьОписание
clean_vehicle0.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_person0.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

Разработка

bash
git clone https://github.com/theYahia/dadata-mcp.gitcd dadata-mcpnpm installnpm run buildnpm test

Тест через MCP Inspector

bash
DADATA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

Откроется интерактивный UI на http://localhost:6274 для вызова инструментов и просмотра JSON-RPC сообщений.

Часть серии WWmcp

Этот сервер — часть открытой серии 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📅 скороСделки, контакты, воронки
...📅46 серверов — полный список на витрине

46 MCP-серверов для российских API: github.com/theYahia/WWmcp

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit 2dc857d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.5LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts