MCP Dadata Server

This MCP server provides a tool to find company or individual entrepreneur information by INN (Идентификационный номер налогоплательщика - Taxpayer Identification Number) or OGRN (Основной государственный регистрационный номер - Primary State Registration Number) using the Dadata.ru API.

Setup

1. Prerequisites

• Python 3.10 or higher.
• uv (Python package installer and virtual environment manager). If you don’t have it, install it by following the instructions at https://astral.sh/uv.

2. Create Environment and Install Dependencies

Open your terminal in the mcp_dadata_server directory and run the following commands:

# Create a virtual environment (if you haven't already for this project)
# uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
# .venvScriptsactivate

# Install dependencies
uv pip install -r requirements.txt

3. Set Dadata API Credentials

This server requires API credentials from Dadata.ru. You need an API Key and a Secret Key.

Set the following environment variables in your terminal session before running the server, or add them to your shell’s configuration file (e.g., .zshrc, .bashrc):

export DADATA_API_KEY="YOUR_DADATA_API_KEY"
export DADATA_SECRET_KEY="YOUR_DADATA_SECRET_KEY"

Replace YOUR_DADATA_API_KEY and YOUR_DADATA_SECRET_KEY with your actual credentials from Dadata.

Running the Server

Once the setup is complete and environment variables are set, you can run the MCP server:

python dadata_server.py

The server will start and be available for MCP clients to connect to. It will print a message indicating it’s running, e.g., INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) (the port might vary if the default is taken).

Exposed Tool

• find_party_by_inn_ogrn(query: str) -> str
  • Description: Finds company or individual entrepreneur information by INN or OGRN using Dadata.
  • Args:
    • query (str): The INN (10 or 12 digits for legal entities/IPs) or OGRN (13 digits for legal entities, 15 for IPs) string.
  • Returns: A JSON string containing the party information if found, or an error message string if not found or an API error occurs.