# matura.lol

> Wyszukiwarka zadań z polskich arkuszy egzaminacyjnych (matura, egzamin
> ósmoklasisty i gimnazjalny, próbne, informatory) z OCR, kluczami
> odpowiedzi i rozwiązaniami. Korpus: tysiące arkuszy i dziesiątki
> tysięcy zadań.

Agents: use the JSON API or the MCP server. Do not crawl the rendered
site — it costs many requests and returns the same data. Never invent a
question or answer: if there is no match, say so. Cite the question id
and paper id. Only `source: "ocr"` is the official CKE key; `site`,
`matugen`, `odrabiamy` and `maturazai` are third-party/curated and `ai`
is model-generated.

## Machine access

- [REST API](https://matura.lol/api): one endpoint per query; `/api/paper/{id}`
  returns a whole exam in a single request.
- [OpenAPI](https://matura.lol/api/openapi.json): full schema.
- [MCP server](https://matura.lol/mcp): Model Context Protocol over streamable HTTP
  (tools: `search_questions`, `get_question`, `get_paper`, `list_facets`).
- [Agent guide](https://matura.lol/agents.md): endpoints, examples, bulk recipes.

## Human site

- [Search](https://matura.lol/): interactive UI.
- [Browse papers](https://matura.lol/browse): subjects and newest papers.
- [About](https://matura.lol/about): sources, method and FAQ.
- [Sitemap](https://matura.lol/sitemap.xml): crawl map.