SudnoKontrol MCP
SudnoKontrol MCP
Model Context Protocol-Server für das ukrainische nationale Schiffsregister — suchen Sie Schiffe nach Registrierungsnummer, Name oder Eigentümer, rufen Sie vollständige Registereinträge ab und fragen Sie aggregierte Statistiken ab. Stellt die öffentlichen Daten des Державний судновий реєстр України (staatliches Schiffsregister) sowie des Суднова книга України (Schiffsbuch) bereit.
Die Daten sind öffentlich und schreibgeschützt — kein API-Schlüssel erforderlich.
Gehosteter Endpunkt (empfohlen):
https://api.sk.ukrfish.org/mcp(Streamable HTTP)Offizielle Dokumentation:
https://sk.ukrfish.org/api-docsundhttps://sk.ukrfish.org/info/ai-agentsEntdeckung:
https://sk.ukrfish.org/llms.txt
Werkzeuge
Werkzeug | Beschreibung |
| Volltext- und strukturierte Suche in beiden nationalen Registern. Deterministische Reihenfolge: exakt übereinstimmende Registrierungsnummern zuerst. Unterstützt kyrillische/lateinische und trennzeichenunempfindliche Nummern ( |
| Gezielte Schiffsabfrage anhand der normalisierten Registrierungsnummer. Liefert den vollständigen Registereintrag. |
| Aggregated öffentliche Schiffsanzahlen („wie viele Schiffe …“). |
| Datensatzkontext: Quellen, Importdaten, Datensatzanzahlen, Felder. |
Jedes Such-/Lookup-Ergebnis enthält eine web_url → https://sk.ukrfish.org/registry? show=<reg>, über die Nutzer einen offiziellen Registerauszug bestellen können (PDF mit QR-Code-Verifizierung, 99,00 грн).
Related MCP server: Trimtab AIS
Schnellstart — gehosteter Server
Claude Code / Claude Desktop
claude mcp add --transport http sudnokontrol https://api.sk.ukrfish.org/mcpCursor
Settings → MCP → Add new MCP server → Name sudnokontrol, Typ HTTP, URL https://api.sk.ukrfish.org/mcp.
Windsurf
Windsurf → MCP → Add server → https://api.sk.ukrfish.org/mcp.
Jeder MCP-Client (Streamable HTTP)
URL: https://api.sk.ukrfish.org/mcp
Auth: none (public, IP rate-limited)Selbst betreiben
Der Server ist ein Proxy für die öffentliche API und benötigt keine Zugangsdaten.
# 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 httpInstallieren Sie direkt aus diesem Repository:
npm install -g github:ailubes/sudnokontrol-mcpUm eine andere Basis-URL anzugeben (z. B. Ihre eigene Bereitstellung):
SUDNOKONTROL_API=https://api.sk.ukrfish.org/api/ai npx sudnokontrol-mcpAus dem Quellcode:
npm install
npm run build
node dist/index.js # stdio
node dist/index.js http # HTTP on :8958/mcpMit Ihrer lokalen Instanz verbinden
claude mcp add --transport http local-sudnokontrol http://127.0.0.1:8958/mcpAPI (zugrunde liegendes REST, kein MCP erforderlich)
Endpunkt | Zweck |
| OpenAPI-3.1-Spezifikation |
| Funktionsaufruf-Tooldefinitionen (JSON : Store) |
| Datensatzkontext |
| Suche |
| Nachschlagen |
| Aggregierte Werte |
Ratenlimit: 300 Anfragen / 15 Minuten / IP auf api/ai/*. Antworten für Suche/Meta/Statistik werden 60 Sekunden lang zwischengespeichert.
Beispiel
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", ... }Lizenz
MIT
Haftungsausschluss
Dies ist ein Open-Source-MCP-Adapter für die public data of the Ukrainian vessel registries operated by SudnoKontrol. Er ist kein offizielles government service.
Available Tools
4 toolsget_dataset_metadataDescribe available vessel-registry datasetsAInspect
Describes available data sources (Державний судновий реєстр / Суднова книга), freshness (import dates), record counts, and available fields.
Inputs: no named parameters.
get_registry_statsGet aggregate vessel countsAInspect
Aggregate public vessel counts for answering "how many vessels" questions.
Inputs: no named parameters.
lookup_vesselLook up a vessel by registration numberAInspect
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_vessel_registriesSearch Ukrainian national vessel registriesAInspect
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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
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.
Maintenance
Related MCP Connectors
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.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides seamless access to official Ukrainian government statistics from the State Statistics Service via their SDMX API. It enables users to query bilingual datasets across domains like energy, demographics, and trade using flexible filtering and metadata exploration tools.5 npm50MIT
- AlicenseNot gradedqualityDmaintenanceProvides real-time, machine-readable ship and port conditions for major US container gateways using AIS data, allowing AI agents to query vessel status, berthing events, and gateway conditions without API keys or signup.1Apache 2.0

Datalastic MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables real-time vessel tracking, port data, maritime weather, and maritime intelligence through 25 tools, allowing AI clients to query live vessel positions, registry, port info, area searches, weather, and more.MIT- AlicenseNot gradedqualityCmaintenanceProvides live vessel positions from Fintraffic's AIS receivers in Finnish and Baltic waters, with tools to query vessels near a point, count vessels in an area, and get details by MMSI. No authentication required.80 npmMIT