Servidor MCP

SudnoKontrol

org.ukrfish.sk/sudnokontrol
Datos y analítica Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches Ukrainian vessel registries, retrieves vessel records, describes registry datasets, and provides aggregate vessel counts.

get_dataset_metadata
Describe available vessel-registry datasets
Describes available data sources (Державний судновий реєстр / Суднова книга), freshness (import dates), record counts, and available fields.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['api', 'data_sources', 'example_queries', 'fields'], 'properties': {'api': {'type': 'object', 'required': ['name', 'version', 'description'], 'properties': {'name': {'type': 'string'}, 'version': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'fields': {'type': 'array', 'items': {'type': 'string'}}, 'data_sources': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'name', 'imported_at', 'record_count'], 'properties': {'name': {'type': 'string'}, 'source': {'type': 'string'}, 'imported_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'record_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}}, 'example_queries': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
get_registry_stats
Get aggregate vessel counts
Aggregate public vessel counts for answering "how many vessels" questions.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['total_vessels', 'sources'], 'properties': {'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'name', 'count'], 'properties': {'name': {'type': 'string'}, 'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'source': {'type': 'string'}}, 'additionalProperties': False}}, 'total_vessels': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}
lookup_vessel
Look up a Ukrainian vessel
Look up a vessel in the Ukrainian vessel registries using its registration number. Handles -, ., and space variance and Latin/Cyrillic forms. Returns the full public registry record, including a web_url pointing to the public vessel information page.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['registration_number'], 'properties': {'registration_number': {'type': 'string', 'minLength': 3, 'description': 'Registration number, for example УПС-0129.'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['registration_number', 'name', 'vessel_type', 'owner_name', 'owner_address', 'build_year', 'home_port', 'tonnage', 'source', 'source_name', 'match', 'web_url'], 'properties': {'name': {'type': 'string'}, 'match': {'type': 'object', 'required': ['field', 'score'], 'properties': {'field': {'type': 'string'}, 'score': {'type': 'number'}}, 'additionalProperties': False}, 'source': {'enum': ['registry', 'book'], 'type': 'string'}, 'tonnage': {'anyOf': [{'anyOf': [{'type': 'string'}, {'type': 'number'}]}, {'type': 'null'}]}, 'web_url': {'type': 'string'}, 'home_port': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'build_year': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'owner_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_name': {'type': 'string'}, 'vessel_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'owner_address': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'registration_number': {'type': 'string'}}, 'additionalProperties': False}
search_vessel_registries
Search Ukrainian national vessel registries
Search public data from the Ukrainian State Ship Registry and Ship Book by free-text query and structured filters. Deterministic ordering with exact registration-number matches first. Handles Cyrillic and Latin scripts and separator-insensitive numbers (УПС-0129 ≡ УПС 0129 ≡ UPS-0129). Each result includes a web_url pointing to the public vessel information page.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'Registration number, vessel name, or owner name. Accepts Latin or Cyrillic.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Page size.'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'source': {'enum': ['registry', 'book', 'both'], 'type': 'string', 'description': 'Dataset to search.'}, 'home_port': {'type': 'string', 'description': 'Partial match on home port.'}, 'vessel_type': {'type': 'string', 'description': 'Partial match on vessel type (e.g. земснаряд).'}, 'build_year_max': {'type': 'integer', 'maximum': 2100, 'minimum': 1900, 'description': 'Inclusive maximum build year.'}, 'build_year_min': {'type': 'integer', 'maximum': 2100, 'minimum': 1900, 'description': 'Inclusive minimum build year.'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'total'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['registration_number', 'name', 'vessel_type', 'owner_name', 'owner_address', 'build_year', 'home_port', 'tonnage', 'source', 'source_name', 'match', 'web_url'], 'properties': {'name': {'type': 'string'}, 'match': {'type': 'object', 'required': ['field', 'score'], 'properties': {'field': {'type': 'string'}, 'score': {'type': 'number'}}, 'additionalProperties': False}, 'source': {'enum': ['registry', 'book'], 'type': 'string'}, 'tonnage': {'anyOf': [{'anyOf': [{'type': 'string'}, {'type': 'number'}]}, {'type': 'null'}]}, 'web_url': {'type': 'string'}, 'home_port': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'build_year': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'owner_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_name': {'type': 'string'}, 'vessel_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'owner_address': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'registration_number': {'type': 'string'}}, 'additionalProperties': False}}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}
Añadido
get_dataset_metadata
17 de September de 2026 a las 12:54
Añadido
get_registry_stats
17 de September de 2026 a las 12:54
Añadido
lookup_vessel
17 de September de 2026 a las 12:54
Añadido
search_vessel_registries
17 de September de 2026 a las 12:54