Integrate DaData for Business Intelligence

@metarebalance/dadata-mcp

31 tools instead of ~4 in the official DaData MCP. Complete DaData API coverage - addresses, companies, banks, phone numbers, emails, passports, vehicles, geocoding, and 12 reference directories. Local installation via npx, no external hosting required. Part of the Russian API MCP series (47 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 Directories (1 tool, 12 directories)

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. Sufficient 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 available only on «Maximum»; basic info free)
• Paid tools (clean_*) - from 0.20 ₽ per request, require DADATA_SECRET_KEY

Request Examples

Find company by INN 7707083893

Standardize address: msk suhonskaya 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 temporary 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

Testing with MCP Inspector

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

An interactive UI will open at http://localhost:6274 to call tools and view JSON-RPC messages.

Part of the Russian API MCP Series

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

50 MCP servers for Russian APIs: github.com/theYahia/russian-mcp