Skip to content
Back to search

digitalpassport-mcp

Read-only MCP server & OpenAPI 3.1 REST API for Belarusian company passports (digitalpassport.by)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/digitalpassport-by--digitalpassport-mcp/badge.svg)](/listings/digitalpassport-by--digitalpassport-mcp)

HTML

<a href="/listings/digitalpassport-by--digitalpassport-mcp"><img src="/api/listings/digitalpassport-by--digitalpassport-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Desktop / Cursor / Windsurf

Add the remote MCP server to your `mcp.json` / `claude_desktop_config.json`:

{
  "mcpServers": {
    "digitalpassport-belarus": {
      "type": "streamable-http",
      "url": "https://digitalpassport.by/api/mcp"
    }
  }
}

Direct JSON-RPC Test (`curl`)

List available tools:

curl -s -X POST https://digitalpassport.by/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Verify a 9-digit UNP checksum:

curl -s -X POST https://digitalpassport.by/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"verify_belarus_unp","arguments":{"unp":"100099082"}}}'

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 84 lines
  1. # Digital Passport Belarus — MCP Server & Open REST API
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  3. [![MCP Protocol](https://img.shields.io/badge/MCP-Streamable%20HTTP-green.svg)](https://digitalpassport.by/.well-known/mcp.json)
  4. [![OpenAPI 3.1](https://img.shields.io/badge/OpenAPI-3.1.0-orange.svg)](https://digitalpassport.by/.well-known/openapi.json)
  5. Public read-only **Model Context Protocol (MCP)** server and **OpenAPI 3.1 REST API** documentation for **[Digital Passport Belarus (digitalpassport.by)](https://digitalpassport.by)** — an open institutional directory of Belarusian legal entities backed by official state registries (EGR, GRP MNS, BelGIE) and structured company profiles.
  6. ## Features
  7. - **Remote Streamable HTTP MCP Server:** Connect directly to `https://digitalpassport.by/api/mcp` without local installation or API keys.
  8. - **4 Read-Only MCP Tools:**
  9. - `get_company_passport` — Fetch a verified company profile by 9-digit UNP or slug (`json` or `markdown`).
  10. - `search_belarus_companies` — Search organizations by name, UNP, city, industry rubric, specialization, or market age.
  11. - `explore_knowledge_graph` — Browse the two-level Belarusian business knowledge graph (broad sectors and specializations).
  12. - `verify_belarus_unp` — Validate the mathematical checksum of a 9-digit Belarusian UNP and identify the registration region.
  13. - **Public REST API (OpenAPI 3.1):** `45 req/min` unauthenticated (`per_page <= 25`), or `300 req/min` with a free `dpk_` key from [digitalpassport.by/developers/api](https://digitalpassport.by/developers/api).
  14. - **AI-Ready Discovery Endpoints:**
  15. - MCP Discovery: [`https://digitalpassport.by/.well-known/mcp.json`](https://digitalpassport.by/.well-known/mcp.json)
  16. - OpenAPI 3.1 Spec: [`https://digitalpassport.by/.well-known/openapi.json`](https://digitalpassport.by/.well-known/openapi.json)
  17. - AI Catalog: [`https://digitalpassport.by/.well-known/ai-catalog.json`](https://digitalpassport.by/.well-known/ai-catalog.json)
  18. - `llms.txt`: [`https://digitalpassport.by/llms.txt`](https://digitalpassport.by/llms.txt)
  19. ---
  20. ## Quick Start (MCP)
  21. ### Claude Desktop / Cursor / Windsurf
  22. Add the remote MCP server to your `mcp.json` / `claude_desktop_config.json`:
  23. ```json
  24. {
  25. "mcpServers": {
  26. "digitalpassport-belarus": {
  27. "type": "streamable-http",
  28. "url": "https://digitalpassport.by/api/mcp"
  29. }
  30. }
  31. }
  32. ```
  33. ### Direct JSON-RPC Test (`curl`)
  34. List available tools:
  35. ```bash
  36. curl -s -X POST https://digitalpassport.by/api/mcp \
  37. -H "Content-Type: application/json" \
  38. -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
  39. ```
  40. Verify a 9-digit UNP checksum:
  41. ```bash
  42. curl -s -X POST https://digitalpassport.by/api/mcp \
  43. -H "Content-Type: application/json" \
  44. -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"verify_belarus_unp","arguments":{"unp":"100099082"}}}'
  45. ```
  46. ---
  47. ## REST API Endpoints
  48. See [`openapi.json`](openapi.json) or the interactive documentation at [https://digitalpassport.by/developers/api](https://digitalpassport.by/developers/api).
  49. - `GET /api/v1/companies` — Search active Belarusian organizations (`q`, `city`, `category`, `specialization`, `per_page`).
  50. - `GET /api/v1/companies/{identifier}` — Retrieve full structured passport JSON by UNP or company slug.
  51. - `GET /api/v1/knowledge-graph` — Retrieve sectors, specializations, and company counts.
  52. Example:
  53. ```bash
  54. curl -s "https://digitalpassport.by/api/v1/companies?q=бетон&per_page=5"
  55. ```
  56. ---
  57. ## Links & Support
  58. - Portal: [https://digitalpassport.by](https://digitalpassport.by)
  59. - Catalog: [https://digitalpassport.by/katalog](https://digitalpassport.by/katalog)
  60. - API Documentation: [https://digitalpassport.by/developers/api](https://digitalpassport.by/developers/api)
  61. - Contact: `info@digitalpassport.by`

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.