Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the DaData in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Suggest and look up Russian addresses, companies and sole proprietors by INN or OGRN (ЕГРЮЛ/ЕГРИП), banks by BIC, full names and emails, reverse geocode coordinates, find the city of an IP and search Russian reference lists with DaData. Optional paid standardisation of addresses, phones and names, switched off until you allow it.
Try asking
Example prompts for DaData
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → DaData, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
DaData + Gemini
Suggest and look up Russian addresses, companies and sole proprietors by INN or OGRN (ЕГРЮЛ/ЕГРИП), banks by BIC, full names and emails, reverse geocode coordinates, find the city of an IP and search Russian reference lists with DaData. Optional paid standardisation of addresses, phones and names, switched off until you allow it.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
DADATA_API_KEY
Step 1 — Get credentials
Setting up takes about 2 minutes. You need a DaData account: the free plan includes 10,000 suggestion and lookup requests a day.
- Sign up at dadata.ru and open Профиль → API-ключи (Profile, API keys).
- Copy the Ключ API (API key), 40 hexadecimal characters, into
DADATA_API_KEY. Paste the key alone, without the wordTokenor spaces: the connector adds theAuthorization: Tokenheader itself. - Optional: copy the Секретный ключ (secret key) from the same page into
DADATA_SECRET_KEY. Everything works without it exceptdadata_get_balance,dadata_get_daily_statsanddadata_clean. - Install the connector and run
dadata_find_partywith the INN 7707083893: it returns that company's ЕГРЮЛ record and costs nothing within the daily limit.
What it reads: address suggestions from free text, with postal code, FIAS/GAR and KLADR ids, OKATO/OKTMO, tax office, coordinates and time zone; one address by FIAS/GAR id, KLADR code or cadastral number; the addresses nearest to a pair of coordinates; the city of an IP address in Russia; companies and sole proprietors from ЕГРЮЛ/ЕГРИП by name, INN, OGRN, address or director, with KPP, OKVED, director, status and registration and liquidation dates; banks by name, BIC, SWIFT or INN, with the correspondent account; full names (ФИО) split into surname, first name and patronymic with the gender; email completion; and DaData's reference lists: passport issuing offices by code, post offices, tax and customs offices, courts, metro stations, car brands, countries, currencies, OKVED2, OKPD2, OKTMO and MKTU classes.
Your plan decides the details: suggestions and lookups are part of your DaData subscription. Paid plans add data fields such as finances and more company details. dadata_find_affiliated, which finds the companies where a person or company is a founder or manager, needs the Maximum plan; other plans answer 403.
How the answers work: for a company by INN the AI asks for the head office (branch_type MAIN) unless you want the branches too; for a company name it suggests first and then looks up the INN it found. Company dates arrive as Unix milliseconds and the AI turns them into normal dates. Address suggestions cover Russia; for Belarus, Kazakhstan, Uzbekistan and other countries the AI widens the search with locations. Email completion does not check that a mailbox exists, and IP lookups only know Russian addresses.
Asks before every paid call: no tool changes anything in your DaData account. The one tool that costs money is the standardisation: before each call the AI checks the balance with dadata_get_balance, tells you how many values will be cleaned and what that will cost, and waits for your yes.
Switched off at install: dadata_clean (Стандартизация). It standardises and checks raw addresses, phones, names, emails, passports, birthdates and vehicles, and DaData charges every value to the account balance on every plan. It needs DADATA_SECRET_KEY, takes up to 50 values per call and is never run in a loop. An administrator turns it on deliberately.
Limits: the free plan includes 10,000 requests a day, and DaData accepts about 30 requests a second. dadata_get_daily_stats shows how much of today's limit is used.
Common errors: 403 with "Feature ... disabled for token" means the API key is wrong or the service is not on your plan: copy the key again from Профиль → API-ключи. 401 on the balance, the statistics or the standardisation means the secret key is missing or wrong. 429 means the rate or the daily limit was reached: wait, or check the usage.
The connector does not top up your balance, change your plan or keys, or confirm that an email mailbox really exists.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell):anythingmcpshould show as connected. - Start prompting: Gemini CLI can now call the
DaDatatools.
Available tools
| Tool | What it does |
|---|---|
dadata_suggest_address | Suggest Russian (and CIS) addresses from free text as the user types: up to 20 normalised variants with postal code, region, city, street… |
dadata_find_address | Look up one address by its FIAS/GAR id, KLADR code or cadastral number and return the full normalised record (postal code, ids… |
dadata_geolocate_address | Reverse geocoding: the addresses nearest to a latitude and longitude in Russia, closest first, within radius_meters |
dadata_iplocate | The city of an IPv4 or IPv6 address (Russian addresses only), as a full address record with KLADR and FIAS ids |
dadata_suggest_party | Suggest Russian companies and sole proprietors (ЕГРЮЛ/ЕГРИП) by name, INN, OGRN, address or director: name, INN, KPP, OGRN, legal address… |
dadata_find_party | Company or sole proprietor by INN or OGRN: the full ЕГРЮЛ/ЕГРИП record (names, KPP, OGRN, OKPO, OKVED, address, director, capital, status… |
dadata_find_affiliated | Companies affiliated with a person or company by its INN: where it is a founder or a manager |
dadata_suggest_bank | Suggest Russian banks by name, BIC, SWIFT, INN or address: BIC, SWIFT, correspondent account, INN, KPP, registration number, address and… |
dadata_find_bank | One bank by BIC, SWIFT, INN (with KPP for a branch) or registration number: names, correspondent account, address, payment city, status |
dadata_suggest_fio | Suggest and split Russian full names (ФИО) as typed: surname, name and patronymic with the detected gender |
dadata_suggest_email | Complete an email address as typed with common domains (mail.ru, yandex.ru, gmail.com and others) |
dadata_suggest_reference | Suggest entries of DaData's Russian reference lists: fms_unit (who issued a passport, by code), postal_unit (post offices by postal code or… |
dadata_get_balance | The DaData account balance in roubles, which paid calls such as dadata_clean spend |
dadata_get_daily_stats | How many suggestions, cleansing (clean) and merging calls the account made on a day, to see how much of the daily limit is used |
dadata_clean | Standardise and check raw values (Стандартизация): addresses with postal code, FIAS ids, coordinates and quality codes; phones with… |
Example prompts
- "Look up the company with INN 7707083893: is it active, who is the director, and what is its legal address and main OKVED code?"
- "Is our supplier Romashka LLC from Kazan still active? Give me its INN, KPP and OGRN."
- "Find the bank with BIC 044525225 and give me its correspondent account and address."
- "Turn this into a full address with postal code and FIAS id: moscow sukhonskaya 11 apt 89."
- "How many DaData requests have we used today, and what is left on the balance?"
FAQ
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?