What is the purpose of the MCP Dadata Server?

The MCP Dadata 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, making it easy to integrate this data into AI Agent workflows.

What is an INN and OGRN?

• INN (Идентификационный номер налогоплательщика) is the Taxpayer Identification Number.
• OGRN (Основной государственный регистрационный номер) is the Primary State Registration Number.

These are unique identifiers for businesses and individual entrepreneurs in Russia.

What are the prerequisites for setting up the MCP Dadata Server?

The prerequisites include:

• Python 3.10 or higher.
• uv (Python package installer and virtual environment manager).

How do I install the dependencies for the server?

1. Create a virtual environment (if you haven’t already): uv venv
2. Activate the virtual environment:
   • On macOS/Linux: source .venv/bin/activate
   • On Windows: .venvScriptsactivate
3. Install dependencies: uv pip install -r requirements.txt

How do I set the Dadata API credentials?

You need to set the following environment variables with your API Key and Secret Key from Dadata.ru:

bash 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.

How do I run the MCP Dadata Server?

After setting the environment variables, run the server using the command:

bash python dadata_server.py

What tool does the MCP Dadata Server expose?

The server exposes the find_party_by_inn_ogrn(query: str) -> str tool.

What does the find_party_by_inn_ogrn tool do?

It finds company or individual entrepreneur information by INN or OGRN using the Dadata API.

What arguments does the find_party_by_inn_ogrn tool accept?

It accepts a single argument:

• query (str): The INN (10 or 12 digits) or OGRN (13 or 15 digits) string.

What does the find_party_by_inn_ogrn tool return?

It returns a JSON string containing the party information if found, or an error message string if not found or an API error occurs.

What is UBOS?

UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and create Multi-Agent Systems.