Ukraine Schools MCP

io.github.Ukraine-Territorial-MCPPublished by GitHub account Ukraine-Territorial-MCPv1.0.0Updated Oct 25, 2026

Ukrainian schools, community search and education budgets. Sources: EDBO, KATOTTG, Open Budget.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Remote MCP server for Ukrainian open data: look up schools, list institutions by community, and check education budget figures.

What you can do
Look up a single educational institution by its EDBO code, including administrative territory, managers, addresses and contacts from EDBO and KATOTTG data (get_school_info). List the educational institutions of a territorial community by its KATOTTG community code (list_schools_by_community). Retrieve planned and actual education budget figures by local budget code and budget year from Open Budget (get_education_budget).
When to use it
Useful when you need quick answers about Ukrainian schools, which community or territory a school belongs to, or how much a local budget plans and spends on education, without querying EDBO, KATOTTG and Open Budget by hand.
Requirements
A remote streamable HTTP endpoint; no authentication, environment variables or headers are declared. The README describes a local Python 3.12 deployment, but it depends on the private Ukraine Data Engine library and KATOTTG catalogue, so self-hosting needs separate access.
Before you install
The README states the public HTTPS address and MCP Registry registration are still to come, so the declared endpoint may not be live. Self-hosting requires a private library that is not publicly available. Data comes from third-party public sources (EDBO, KATOTTG, Open Budget) and may be incomplete or out of date; the tools are read-only.

Installation

In SourceWeft

  1. Open Ukraine Schools 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-schools-mcp/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-schools": {
      "type": "http",
      "url": "https://mcp.edeputat.com/schools/mcp"
    }
  }
}

README

Ukraine Schools MCP

MCP-сервер для отримання відкритих даних про заклади освіти України, їхню територіальну належність і фінансування освіти.

Джерела даних

  • ЄДЕБО — інформація про заклади освіти, керівників, адреси та контакти.
  • КАТОТТГ — області, райони, територіальні громади та населені пункти.
  • Open Budget — планові та фактичні видатки на освіту.

MCP-інструменти

get_school_info

Отримання інформації про конкретний заклад освіти за його кодом ЄДЕБО.

Параметр: school_id.

list_schools_by_community

Отримання переліку закладів освіти громади за кодом КАТОТТГ.

Параметр: community_code.

get_education_budget

Отримання бюджетних показників за освітніми програмами.

Параметри:

  • budget_code — код місцевого бюджету;
  • year — бюджетний рік.

Технології

  • Python 3.12
  • MCP Streamable HTTP
  • Ukraine Data Engine 0.1.0

Запуск

Основний застосунок: server:app.

Приклад локального запуску після встановлення залежностей:

bash
uvicorn server:app --host 127.0.0.1 --port 8915

MCP endpoint: /mcp.

Залежності

Ukraine Data Engine наразі є приватною бібліотекою.

Цей репозиторій містить код MCP-сервера, але для самостійного розгортання потрібен окремий доступ до бібліотеки Ukraine Data Engine та каталогу КАТОТТГ.

Тестування

Публічні структурні тести:

bash
python3 -m unittest discover -s tests -v

Повний інтеграційний тест виконується в середовищі з установленим Ukraine Data Engine.

Статус

Version 1.0 — три MCP-інструменти перевірені.

Публічна HTTPS-адреса та реєстрація в MCP Registry будуть додані після розгортання.

Source: README.md at commit b595562

Tools

3

get_school_info

Get school details and administrative territory.

Parametersschool_idrequired

list_schools_by_community

List educational institutions by Ukrainian KATOTTG community.

Parameterscommunity_coderequired

get_education_budget

Get education budget plans and actual expenses from Open Budget.

Parametersyearbudget_coderequired

Version history

1
  1. v1.0.0LatestOct 25, 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.