# edu-hub

> Public, curated data about the Polish education system (preschool to upper secondary), served as a REST API and an MCP server. Every record carries provenance (source URL, retrieval time, licence). Compiled for information; not an official legal text.

## MCP
- Endpoint: https://edu.ippe.uk/mcp (Streamable HTTP, protocol 2026-07-28 with 2025-era fallback, no auth required)
- Tools: edu_search_institutions, edu_get_institution, edu_search_territorial_units, edu_search_legal_acts, edu_get_legal_act, edu_get_applicable_curriculum, edu_get_curriculum_timeline, edu_search_qualifications, edu_get_qualification, search, fetch, edu_list_data_sources, edu_list_reference_values

## REST
- [OpenAPI 3.1](https://edu.ippe.uk/openapi.json)
- [API reference](https://edu.ippe.uk/docs)
- Institutions (RSPO + SIO): https://edu.ippe.uk/v1/institutions?query=liceum+krakow
- Legal acts (ELI): https://edu.ippe.uk/v1/legal-acts/DU/2017/59
- Applicable core curriculum: https://edu.ippe.uk/v1/curriculum/applicable?schoolType=szkola-podstawowa&grade=6&schoolYear=2027/2028
- Vocational qualifications (ZRK): https://edu.ippe.uk/v1/qualifications/INF.02
- Sources and freshness: https://edu.ippe.uk/v1/sources

## Conventions
- JSON fields are camelCase; values are Polish (canonical) with English labels where curated.
- School years are written 2026/2027 and start on 1 September; time-dependent endpoints take schoolYear or asOf.
- Parameters have the same names in REST and MCP; repeat a query parameter for several values.
- Errors are RFC 9457 problem details with a stable `code` (https://edu.ippe.uk/problems), localised by Accept-Language; pagination uses opaque cursors.