# io.github.Ukraine-Territorial-MCP/ukraine

> Ukraine territorial MCP: 31,744 KATOTTG records, administrative hierarchy and local MCP endpoints.

- name: io.github.Ukraine-Territorial-MCP/ukraine
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 76/100 flags: no-repository
- quality: 79/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.Ukraine-Territorial-MCP%2Fukraine
- tools: https://api.protogrid.dev/v1/servers/io.github.Ukraine-Territorial-MCP%2Fukraine/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "ukraine": {
      "type": "http",
      "url": "https://community.ukrdigital.org/mcp/ukraine/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 98
- freshness: 100
- provenance: 35
- drivers: +reachable +uptime-95% +updated-5d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (new)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list_datasets (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); describe_dataset (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_catalog_info (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 910 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 4 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 910 tokens to load them all
- tool set hash: 58f4791a7d86b2b9d232c2e9da2632ca
- tools last changed: 2026-10-19T23:47:45.385Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.Ukraine-Territorial-MCP/ukraine.svg)](https://protogrid.dev/servers/io.github.Ukraine-Territorial-MCP/ukraine)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `describe_dataset` added
  - Опис та параметри публічно доступного набору даних.
- 2026-10-19 `list_datasets` added
  - Перелік активних і явно опублікованих наборів даних України.
- 2026-10-18 `get_welcome` added
  - Привітання, можливості, досягнення та плани MCP України.
- 2026-10-18 `list_special_territories` added
  - Перелік трьох територій першого рівня з особливим статусом: Автономна Республіка Крим, Київ та Севастополь.
- 2026-10-18 `search_territories_detailed` added
  - Пошук територій України з адміністративними назвами, фільтрами області, району, громади та посторінковою видачею. Використовуй для розрізнення однойменних населених пунктів.
- 2026-10-18 `list_first_level_territories` added
  - Перелік 27 територій першого рівня: 24 області, АР Крим, Київ і Севастополь.
- 2026-10-18 `list_oblasts` added
  - Перелік 24 областей України з обласними радами та кодами ЄДРПОУ.
- 2026-10-18 `list_territories` changed (inputSchema)
- 2026-10-18 `search_territories` changed (description, inputSchema, outputSchema) **meaning changed**
  - before: Пошук територій України за українською або транслітерованою назвою.
  - after: Пошук територій із повними адміністративними адресами, фільтрами та пагінацією. Повертає total, offset, limit, results.

Full history: https://api.protogrid.dev/v1/servers/io.github.Ukraine-Territorial-MCP%2Fukraine/changes

## Remotes

- https://community.ukrdigital.org/mcp/ukraine/mcp (streamable-http, auth none, reachable true, uptime30d 0.94736844)

## Packages

_none_

## Tools (13)

- `describe_dataset`: Опис та параметри публічно доступного набору даних.
- `get_catalog_info`: Інформація про загальноукраїнський каталог територій.
- `get_hierarchy`: Отримати адміністративну ієрархію території.
- `get_mcp_endpoint`: Отримати HTTPS-адресу територіального MCP.
- `get_territory`: Отримати територію за кодом КАТОТТГ.
- `get_welcome`: Привітання, можливості, досягнення та плани MCP України.
- `list_datasets`: Перелік активних і явно опублікованих наборів даних України.
- `list_first_level_territories`: Перелік 27 територій першого рівня: 24 області, АР Крим, Київ і Севастополь.
- `list_oblasts`: Перелік 24 областей України з обласними радами та кодами ЄДРПОУ.
- `list_special_territories`: Перелік трьох територій першого рівня з особливим статусом:
    Автономна Республіка Крим, Київ та Севастополь.
    
- `list_territories`: Перелік територій із фільтрами та посторінковою видачею.
- `search_territories`: Пошук територій із повними адміністративними адресами,
    фільтрами та пагінацією. Повертає total, offset, limit, results.
    
- `search_territories_detailed`: Пошук територій України з адміністративними назвами,
    фільтрами області, району, громади та посторінковою видачею.
    Використовуй для розрізнення однойменних населених пунктів.
    
