Integrate DaData for Business Intelligence

MCP Server for DaData - Address Suggestions, Company Verification by INN, and AI-Powered Data Cleaning

Looking for how to connect DaData to an AI, verify a counterparty by INN, parse an address into components, or clean a phone and email database? This is it. 31 tools instead of ~4 from the official DaData MCP: addresses, companies, banks, phones, passports, vehicles, geocoding, and 12 reference databases-23 methods are free. Installs locally via npx, no external hosting needed-your API key stays with you. Part of the WWmcp series (46 servers) by @theYahia.

English version (README.en.md)

Why This One Instead of the Official DaData MCP?

DaData has an official MCP server with 4 tools. Our package covers the entire API:

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "dadata": {
      "command": "npx",
      "args": ["-y", "@metarebalance/dadata-mcp"],
      "env": {
        "DADATA_API_KEY": "your-api-key",
        "DADATA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Claude Code

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

VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "dadata": {
      "command": "npx",
      "args": ["-y", "@metarebalance/dadata-mcp"],
      "env": {
        "DADATA_API_KEY": "your-api-key",
        "DADATA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Windsurf

Add to MCP Toolkit settings:

{
  "mcpServers": {
    "dadata": {
      "command": "npx",
      "args": ["-y", "@metarebalance/dadata-mcp"],
      "env": {
        "DADATA_API_KEY": "your-api-key",
        "DADATA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Tools (31)

Addresses (3)

Companies (8)

Banks (1)

Full Names (2)

Contacts (3)

Passports (3)

Vehicles (2)

Geolocation (2)

Mail and Countries (2)

Logistics (1)

Composite Check (1)

Reference Databases (1 tool, 12 databases)

Account (2)

Resources

• dadata://reference/quality-codes - DaData quality code reference (qc, qc_geo) and confidence levels
• dadata://reference/capabilities - API capabilities: free/paid features, limits

Prompts

• check_counterparty - Counterparty verification by INN: status, management, financials, risk assessment
• validate_address - Step-by-step address validation with quality assessment

Environment Variables

Pricing and Limits

Details: dadata.ru/pricing

• Free plan: up to 10,000 requests per day. Enough for development and small projects.
• «Maximum» plan required for:
  • find_affiliated - affiliated company search (does not work on free plan)
  • find_company_by_id - full data (financials, all OKVED codes come only on «Maximum»; basic info is free)
• Paid tools (clean_*) - from 0.20 ₽ per request, require DADATA_SECRET_KEY

Request Examples

Find company by INN 7707083893

Standardize address: msk sukhonska 11 apt 89

Check counterparty with INN 7736207543 — is the company active?

What city is IP 46.226.227.20 in?

Find BIC and correspondent account for Sberbank

Check passport 4510 235857 — is it in the invalid registry?

Find OKVED for "software development"

Security

• API keys are never logged and never appear in error responses
• All input data validated via Zod schemas
• Path traversal protection when building endpoints
• Strict 10-second timeout on all HTTP requests
• Retry logic with exponential backoff only for transient errors (429, 5xx)
• stdout reserved for JSON-RPC - logs go to stderr

Development

git clone https://github.com/theYahia/dadata-mcp.git
cd dadata-mcp
npm install
npm run build
npm test

Test via MCP Inspector

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

Opens an interactive UI at http://localhost:6274 to call tools and view JSON-RPC messages.

Part of the WWmcp Series

This server is part of an open series of MCP servers for Russian APIs:

46 MCP servers for Russian APIs: github.com/theYahia/WWmcp