Ukraine Territorial MCP

io.github.Ukraine-Territorial-MCPPublished by GitHub account Ukraine-Territorial-MCPv1.0.1Updated Oct 24, 2026

Explore Ukraine's KATOTTG territories, administrative hierarchy, and local government councils.

VerifiedStreamable HTTPWeb executableLocation & LifestyleKnowledge & Memory

Overview

AI-generated overview

Remote MCP server giving assistants structured access to Ukraine's KATOTTG territories, administrative hierarchy and local government councils.

What you can do
Look up and search territories by name, filters or KATOTTG code, with pagination and full administrative addresses, and distinguish settlements sharing a name via detailed search and hierarchy lookup. Browse the catalog: first-level territories, the 24 oblasts, special-status territories, and catalog info. Query councils: search, retrieve and list district councils and confirmed local councils by name, EDRPOU or KATOTTG code. Explore published datasets: list active datasets and describe their parameters. Retrieve the territorial MCP endpoint address and project welcome information.
When to use it
Useful when an assistant needs Ukrainian administrative geography — resolving a settlement to its oblast, raion or hromada, disambiguating same-named places, or looking up a local or district council by EDRPOU or KATOTTG code. Suited to research, data preparation and reference lookups rather than legal decisions.
Requirements
A remote Streamable HTTP MCP endpoint; no local runtime, package, account, API key or environment variable is declared. The client must support remote Streamable HTTP servers, and tool availability depends on the client refreshing its tool list.
Before you install
The README states that record completeness and currency may vary and that data comes from open state registers with differing verification methods; for legally significant decisions it advises checking current primary sources. The server is read-only lookup, but the README notes that full server source and self-hosting instructions are not yet published.

Installation

In SourceWeft

  1. Open Ukraine Territorial MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Ukraine-Territorial-MCP%2Fukraine/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Ukraine Territorial MCP 🇺🇦

The primary repository and official entry point for the Ukraine Territorial MCP project.

Українською · English · MCP endpoint

Main project / Головний проєкт Core development, documentation, integrations, and future releases are coordinated here. The other repositories in the Ukraine-Territorial-MCP organization—many named by KATOTTG codes—represent derived territorial components, experiments, or works in progress. Start here, not from an individual territorial repository.

Українською

Ukraine Territorial MCP — відкритий проєкт для доступу ШІ-асистентів і розробників до адміністративно-територіального устрою України та структурованих даних про органи місцевого самоврядування через Model Context Protocol (MCP).

Поточний стан (жовтень 2026)

  • 31 744 територіальні записи каталогу КАТОТТГ.
  • 19 інструментів, перевірених через публічне HTTPS-підключення MCP.
  • 1 556 зіставлених місцевих рад: назва, ЄДРПОУ, код КАТОТТГ відповідного населеного пункту. Статус зіставлення визначений за наявними даними; повнота й актуальність окремих записів можуть відрізнятися.
  • Підтримка даних про області, райони, громади, населені пункти, обласні й районні ради.
  • Подальше наповнення реєстрів і тематичних модулів триває.

Підключення

Публічна MCP-адреса:

text
https://community.ukrdigital.org/mcp/ukraine/mcp

Використовуйте її у MCP-клієнті з підтримкою віддалених серверів Streamable HTTP. Доступність окремих інструментів залежить також від оновлення списку інструментів у клієнті.

Приклади інструментів:

  • search_local_councils — пошук місцевої ради за назвою, ЄДРПОУ чи КАТОТТГ;
  • get_local_council — дані про конкретну місцеву раду;
  • list_local_councils — список рад із пагінацією;
  • search_district_councils, get_district_council, list_district_councils — районні ради.

Структура проєкту

Цей репозиторій є центральним джерелом документації та майбутніх релізів. Багато інших репозиторіїв організації названі за кодами КАТОТТГ і є похідними територіальними компонентами або прототипами. Вони не є альтернативними головними версіями національного сервера. Для інтеграції використовуйте посилання на MCP вище.

Статус цього GitHub-репозиторію: документація створена; синхронізація вихідного коду з робочим сервером та інструкції локального розгортання готуються. Наявність публічного MCP endpoint не означає, що повний серверний код уже опубліковано тут.

Джерела та відповідальність

Проєкт використовує КАТОТТГ і зіставлені дані відкритих державних реєстрів. Записи можуть мати різні методи підтвердження. Дані надаються для пошуку й аналізу; для юридично значущих рішень перевіряйте актуальні першоджерела.

English

Ukraine Territorial MCP gives AI agents and developers structured access to Ukrainian administrative geography and local-government information through the Model Context Protocol.

Project status (October 2026)

  • 31,744 territorial catalog records (KATOTTG).
  • 19 MCP tools verified through the public HTTPS endpoint.
  • 1,556 mapped local councils, with council names, EDRPOU identifiers, and KATOTTG settlement identifiers.
  • Regional and district council data, with ongoing expansion to additional official open-data sources.

Connect

Remote MCP server (Streamable HTTP):

text
https://community.ukrdigital.org/mcp/ukraine/mcp

For discovery, integration, documentation, and contributions, use this repository as the primary entry point. Other KATOTTG-named repositories in the organization are derived components or under development. Server source publication and self-hosting instructions are being prepared; this repository currently serves as the official project landing page.

Roadmap

  • Publish reviewed server source and deployment instructions without credentials or private data.
  • Improve data provenance, validation, and source freshness.
  • Expand local-government coverage, contacts, budgets, procurements, and related public datasets.
  • Improve MCP tool discovery and documentation.

Organization: Ukraine-Territorial-MCP · Live MCP: community.ukrdigital.org

Source: README.md at commit d11d120

Tools

19

get_catalog_info

Інформація про загальноукраїнський каталог територій.

Takes no parameters.

search_territories

Пошук територій із повними адміністративними адресами, фільтрами та пагінацією. Повертає total, offset, limit, results.

Parameterslimitqueryrequiredoffsetregion_codedistrict_codecommunity_code

get_territory

Отримати територію за кодом КАТОТТГ.

Parameterscoderequired

get_hierarchy

Отримати адміністративну ієрархію території.

Parameterscoderequired

list_territories

Перелік територій із фільтрами та посторінковою видачею.

Parameterslimitoffsetcategoryregion_codedistrict_codecommunity_codeterritory_type

get_mcp_endpoint

Отримати HTTPS-адресу територіального MCP.

Parameterscoderequired

list_oblasts

Перелік 24 областей України з обласними радами та кодами ЄДРПОУ.

Takes no parameters.

list_first_level_territories

Перелік 27 територій першого рівня: 24 області, АР Крим, Київ і Севастополь.

Takes no parameters.

search_territories_detailed

Пошук територій України з адміністративними назвами, фільтрами області, району, громади та посторінковою видачею. Використовуй для розрізнення однойменних населених пунктів.

Parameterslimitqueryrequiredoffsetregion_codedistrict_codecommunity_code

list_special_territories

Перелік трьох територій першого рівня з особливим статусом: Автономна Республіка Крим, Київ та Севастополь.

Takes no parameters.

get_welcome

Привітання, можливості, досягнення та плани MCP України.

Takes no parameters.

list_datasets

Перелік активних і явно опублікованих наборів даних України.

Takes no parameters.

describe_dataset

Опис та параметри публічно доступного набору даних.

Parametersdataset_idrequired

search_district_councils

Шукати районні ради України за назвою.

Parameterslimitqueryrequiredregion

get_district_council

Отримати районну раду за ЄДРПОУ або кодом КАТОТТГ району.

Parametersidentifierrequired

list_district_councils

Перелічити райони України та відповідні районні ради.

Parametersregion

search_local_councils

Пошук підтверджених місцевих рад України за назвою, ЄДРПОУ або КАТОТТГ населеного пункту.

Parameterslimitqueryrequired

get_local_council

Отримати місцеву раду за ЄДРПОУ або кодом КАТОТТГ населеного пункту.

Parametersidentifierrequired

list_local_councils

Список підтверджених місцевих рад України з пагінацією.

Parameterslimitoffset

Version history

2
  1. v1.0.1LatestOct 24, 2026
  2. v1.0.0Oct 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.