Skip to main content
Glama
theYahia

@metarebalance/dadata-mcp

by theYahia

@metarebalance/dadata-mcp

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

npm License: MIT

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-пакет

Нет

Да

Related MCP server: amoCRM MCP Server

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

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

Install Server
A
license - permissive license
A
quality
F
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    A comprehensive MCP server providing 30 tools for geocoding, routing, and OpenStreetMap data analysis. It enables AI assistants to search for locations, calculate travel routes, and perform quality assurance checks on map data.
    Last updated
    30
    2
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for verifying Russian counterparties (legal entities and individual entrepreneurs) via public Federal Tax Service data: EGRUL/EGRIP, bankruptcy registry (EFRSB), Transparent Business, bailiff service (FSSP), and arbitration courts (KAD).
    Last updated
    8
    12
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    MCP server for T-Kassa (T-Bank/Tinkoff) payment API. Provides 16 tools for payments, refunds, recurring charges, customer management, saved cards, SBP, receipts, and T-Invest portfolio.
    Last updated
    62
    MIT

View all related MCP servers

Related MCP Connectors

  • 350+ production-ready APIs through one MCP server — weather, geocoding, validation, financial data.

  • Identity resolution MCP server for phone/email lookups across 31+ services. Global + India coverage.

  • Remote MCP server to enrich company profiles with structured B2B data and confidence scores.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/dadata-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server