The server provides read-only, API-key-free access to Ukraine's national vessel registries (Державний судновий реєстр України and Суднова книга України).
search_vessel_registries: Free-text and structured search across both registries by registration number, vessel name, owner, home port, vessel type, and build year range; deterministic ordering puts exact registration-number matches first; supports Cyrillic/Latin and separator-insensitive numbers.
lookup_vessel: Exact vessel lookup by normalized registration number, returning the full registry record plus a web_url to the public vessel information page.
get_registry_stats: Answer aggregate "how many vessels" questions with public vessel counts.
get_dataset_metadata: Get dataset context — sources, import dates, record counts, and available fields.
Every search/lookup result includes a web_url to the public site for viewing the vessel or ordering an official registry excerpt.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SudnoKontrol MCP Look up vessel УПС-4249 in the Ukrainian registry"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol server for the Ukrainian national vessel registry — search vessels by registration number, name or owner, look up full registry records, and query aggregate statistics. Exposes the public data of the Державний судновий реєстр України (State Ship Registry) and the Суднова книга України (Ship Book).
Data is read-only and public — no API key required.
Hosted endpoint (recommended): https://api.sk.ukrfish.org/mcp (Streamable HTTP)
Project docs: https://sk.ukrfish.org/api-docs and https://sk.ukrfish.org/info/ai-agents
Discovery: https://sk.ukrfish.org/llms.txt
Tool | Description |
| Free-text + structured search across both national registries. Deterministic ordering: exact registration-number matches first. Supports Cyrillic/Latin and separator-insensitive numbers ( |
| Exact vessel lookup by normalized registration number. Returns full registry record. |
| Aggregate public vessel counts ("how many vessels..."). |
| Dataset context: sources, import dates, record counts, fields. |
Every search/lookup result includes a web_url → https://sk.ukrfish.org/registry?vessel=<reg> pointing to the public vessel information page.
Related MCP server: Trimtab AIS
claude mcp add --transport http sudnokontrol https://api.sk.ukrfish.org/mcpSettings → MCP → Add new MCP server → Name sudnokontrol, Type HTTP, URL https://api.sk.ukrfish.org/mcp.
Windsurf → MCP → Add server → https://api.sk.ukrfish.org/mcp.
URL: https://api.sk.ukrfish.org/mcp
Auth: none (public, IP rate-limited)The server proxies the public API and needs no credentials.
# stdio (for Claude Desktop "command" servers)
npx sudnokontrol-mcp
# HTTP (streamable)
npx sudnokontrol-mcp http
# or: PORT=9000 HOST=127.0.0.1 npx sudnokontrol-mcp httpInstall from this repo directly:
npm install -g github:ailubes/sudnokontrol-mcpTo point at a different base (e.g. your own deployment):
SUDNOKONTROL_API=https://api.sk.ukrfish.org/api/ai npx sudnokontrol-mcpFrom source:
npm install
npm run build
node dist/index.js # stdio
node dist/index.js http # HTTP on :8958/mcpclaude mcp add --transport http local-sudnokontrol http://127.0.0.1:8958/mcpEndpoint | Purpose |
| OpenAPI 3.1 spec |
| Function-calling tool definitions (JSON Schema) |
| Dataset context |
| Search |
| Lookup |
| Aggregates |
Rate limit: 300 requests / 15 min / IP on /api/ai/*. Search/meta/stats responses cached 60s.
User: Is the vessel УПС-4249 registered?
Agent calls: lookup_vessel {"registration_number": "УПС-4249"}
Response: { registration_number: "УПС-4249", name: "ua 5614 KV", owner_name: "ТОВ Соціальні ініціативи Запоріжжя", source: "registry", web_url: "https://sk.ukrfish.org/registry?vessel=УПС-4249", ... }MIT
This is an open-source MCP adapter for the public data of the Ukrainian vessel registries operated by SudnoKontrol. It is not an official government service.
Describes available data sources (Державний судновий реєстр / Суднова книга), freshness (import dates), record counts, and available fields.
Inputs: no named parameters.
Aggregate public vessel counts for answering "how many vessels" questions.
Inputs: no named parameters.
Exact vessel lookup by normalized registration number (handles -, ., and space variance, and Latin/Cyrillic forms). Returns full registry data plus a web_url to the public site for ordering an official excerpt.
Inputs: registration_number (required).
Search Державний судновий реєстр України and Суднова книга України by free-text query and structured filters. Deterministic ordering with exact registration-number matches first. Each result includes a web_url linking to the public site for ordering an official registry excerpt.
Inputs: q, limit, offset, source, +4 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 4 tools
Each tool has a distinct purpose: dataset metadata, free-text search, exact registration-number lookup, and aggregate statistics. No overlaps in function; even search and lookup are clearly separated by exact vs. fuzzy matching.
All tool names follow the same verb_noun snake_case convention: get_dataset_metadata, search_vessel_registries, lookup_vessel, get_registry_stats. Consistent and predictable.
4 tools is well-scoped for a read-only registry API. Each tool covers a necessary operation without redundancy or bloat.
The surface fully covers the domain's read-side: metadata discovery, flexible search, exact lookup, and statistics. No essential operations are missing for the stated purpose.
Vessel tracking for 750,000+ ships, with ownership, inspections, port records, routes, and more.
Maritime intelligence: vessels, tracks, port calls, company fleets and sanctions screening, sourced.
Public Data Ukraine Mcp connects AI agents to real public APIs via MCP. Tools include
Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.
