# Digital Passport Belarus

> Digital Passport Belarus is a free MCP server for legal and government. Read-only MCP server and REST API for verifying Belarusian companies by UNP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://digitalpassport.by/developers/api
- **Repository:** https://github.com/digitalpassport-by/digitalpassport-mcp
- **MCP Registry name:** by.digitalpassport/registry-mcp
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

The README describes this as a public, read-only Model Context Protocol server and OpenAPI 3.1 REST API covering Belarusian legal entities drawn from official state registries such as EGR, GRP MNS and BelGIE. Company passports can be looked up by 9-digit UNP or slug, returned as JSON or Markdown, and searched by name, city, industry rubric or specialization.

An AI client connects to a single streamable-http endpoint and calls one of four tools: passport lookup, company search, knowledge graph browsing, and a UNP checksum check that also reports the registration region. Unauthenticated use is capped at 45 requests per minute per IP with up to 25 results per page, while a free key issued to verified companies raises the limit to 300 per minute and unlocks more fields.

The service suits counterparty due diligence, supplier checks and developers building business-data features for Belarus. The site also publishes llms.txt, a discovery manifest and conditional ETag caching for crawlers.

## Features

- **UNP lookup and checksum:** Fetches a company profile by its 9-digit UNP and validates the UNP checksum.
- **Company search:** Searches organizations by name, UNP, city, industry rubric, specialization or market age.
- **Knowledge graph browsing:** Exposes a two-level graph of broad sectors and specializations with company counts.
- **Markdown and JSON formats:** Returns passports and catalog listings as JSON or Markdown, with Schema.org JSON-LD markup.
- **Tiered API access:** Offers unauthenticated rate limits and a free partner key with higher limits and fuller fields.

## Good for

- Checking the registration status of a Belarusian counterparty before signing a contract
- Adding Belarusian company data to an AI assistant through MCP
- Looking up suppliers by specialization or city in Belarus
- Validating UNP numbers in forms or accounting systems
- Building integrations that read company profiles via the REST API

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http registry-mcp https://digitalpassport.by/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://digitalpassport.by/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "registry-mcp": {
      "url": "https://digitalpassport.by/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "registry-mcp": {
      "type": "http",
      "url": "https://digitalpassport.by/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "registry-mcp": {
      "serverUrl": "https://digitalpassport.by/api/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://digitalpassport.by/api/mcp
```

Enter a Name (for example "Digital Passport Belarus"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "registry-mcp": {
      "type": "http",
      "url": "https://digitalpassport.by/api/mcp"
    }
  }
}
```

## Tools

All 4 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `get_company_passport` (says read-only): Получить проверяемый цифровой паспорт белорусской компании по 9-значному УНП или слагу карточки. Инструмент только читает уже опубликованные паспорта и ничего не создаёт.
- `search_belarus_companies` (says read-only): Поиск белорусских организаций по названию, бренду, УНП, городу или специализации из графа знаний. Работает строго в режиме чтения.
- `explore_knowledge_graph` (says read-only): Просмотр двухуровневого графа знаний белорусского бизнеса: широких направлений и канонических специализаций с количеством подтверждённых компаний. Работает строго в режиме чтения.
- `verify_belarus_unp` (says read-only): Проверить математическую контрольную сумму 9-значного УНП Беларуси и определить регион регистрации.

## FAQ

### Does the MCP server require an API key?

The README says the remote Streamable HTTP MCP server can be used directly at https://digitalpassport.by/api/mcp without local installation or API keys.

### What rate limits apply to the public API?

Unauthenticated requests are limited to 45 per minute per IP with up to 25 results per page. A free dpk_ key for verified companies raises the limit to 300 per minute.

### Which MCP tools are exposed?

The README lists four read-only tools: get_company_passport, search_belarus_companies, explore_knowledge_graph and verify_belarus_unp.

### Is there a charge for the service?

The API page states the platform is open without paid tiers, and partner keys are issued free of charge.

### Is Digital Passport Belarus free?

Yes. Digital Passport Belarus is free to use.

### How do I add Digital Passport Belarus to Claude Code?

Run this command in your terminal: claude mcp add --transport http registry-mcp https://digitalpassport.by/api/mcp

### What are the best alternatives to Digital Passport Belarus?

The closest alternatives to Digital Passport Belarus are GlobalEntity API, Krs MCP, Baltic Company Check, Реестр реестров: Russian state registries and ImonesMCP.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [GlobalEntity API](https://ai-powered.com/mcp/globalentity-api): GlobalEntity API is a paid MCP server for analytics and data.
- [Krs MCP](https://ai-powered.com/mcp/krs-mcp): Krs MCP is an open-source MCP server for legal and government.
- [Baltic Company Check](https://ai-powered.com/mcp/baltic-company-check): Baltic Company Check is a paid MCP server for finance and payments.
- [Реестр реестров: Russian state registries](https://ai-powered.com/mcp/russian-state-registries): Реестр реестров: Russian state registries is a freemium MCP server for legal and government.
- [ImonesMCP](https://ai-powered.com/mcp/imonesmcp): ImonesMCP is a freemium MCP server for legal and government.
- [GLEIF LEI Company Lookup](https://ai-powered.com/mcp/gleif-lei-company-lookup): GLEIF LEI Company Lookup is an open-source MCP server for finance and payments.
- [UK Companies House](https://ai-powered.com/mcp/uk-companies-house-4): UK Companies House is an MCP server for legal and government.
- [Belgium Data Desk](https://ai-powered.com/mcp/belgium-data-desk): Belgium Data Desk is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/digital-passport-belarus
