osym-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
osym-mcp 🇹🇷
mcp-name: io.github.mohammad-abbasi-sh/osym-mcp
Unofficial read-only MCP server for ÖSYM (www.osym.gov.tr) — Türkiye's national exam authority (T.C. Ölçme, Seçme ve Yerleştirme Merkezi): the announcements index (476 announcements in 2026 as of 18 Nov 2026, searchable per year back to 2010), full announcement texts with their guide PDFs, the official exam calendar (95 exams: YKS, KPSS, ALES, TUS, YDS, DGS, e-YDS, e-TEP and ~30 more groups, with application / late-application / exam / result / preference dates), and per-group announcement lists.
Part of the "Turkey MCP factory". Not affiliated with ÖSYM. Data comes from ÖSYM's own public pages (server-rendered HTML) — no login, no API key, read-only. Personal exam results live behind a login at sonuc.osym.gov.tr / ais.osym.gov.tr and are not covered: this server only exposes the public announcements, calendar and group pages.
For AI agents
Announcements:
osym_latest_announcementsreturns the newest items first (title, date DD.MM.YYYY, slug, URL). The index page serves one year at a time — passyear(2010–2026) for older years (/Duyurular/Index/2025returns 2025's 507 items).Search is Turkish-insensitive:
"kpss"finds"KPSS","sonuc"finds"Sonuçları". Search runs over the full year's list (476 items in 2026).Full text:
osym_get_announcementtakes a slug (or a full osym.gov.tr URL) and returns the title, date, body text and links — guide PDFs on dokuman.osym.gov.tr come first.Calendar:
osym_exam_calendarreturns one row per exam with 8 date columns."-"cells (not applicable) arenull; date ranges that run together on the site ("07.01.2026 14:0015.01.2026 23:59") are kept verbatim.queryfilters by exam name/code ("yks","kpss","e-yds");upcoming_onlykeeps exams whose exam date is today or later.Groups:
osym_exam_groupwith no argument lists all 30+ exam groups (code, id, full name); with a code ("yks"), full name ("Kamu Personel Seçme Sınavı") or numeric id ("3") it returns that group's announcements.Every response carries
fetched_at(UTC) andsource: www.osym.gov.tr.
Related MCP server: NTU Course Index MCP
Install
uvx osym-mcpOr add to your MCP client config (e.g. Claude Desktop):
{
"mcpServers": {
"osym": {
"command": "uvx",
"args": ["osym-mcp"]
}
}
}Tools
Tool | What it does |
| Newest ÖSYM announcements, newest first (limit 1–50; optional |
| Search announcements by title, Turkish-insensitive (optional |
| Full text of one announcement by slug or URL, with guide-PDF links |
| Official exam calendar: 95 exams with application / exam / result / preference dates (optional |
| One exam group's announcements — or the full group list when called with no argument |
| Is ÖSYM's site reachable right now? |
Example
Latest announcements, 18 November 2026:
{ "year": "current", "count": 2, "total_on_page": 476,
"announcements": [
{ "title": "2026-GUY/2 Sınava Giriş Belgeleri Erişime Açıldı",
"date": "16.11.2026",
"slug": "2026-guy2-sinava-giris-belgeleri-erisime-acildi",
"url": "https://www.osym.gov.tr/2026-guy2-sinava-giris-belgeleri-erisime-acildi" },
{ "title": "2026 KPSS Ön Lisans Sınavı: Branş Bazında Sıralamalar",
"date": "12.11.2026",
"slug": "2026-kpss-on-lisans-sinavi-brans-bazinda-siralamalar",
"url": "https://www.osym.gov.tr/2026-kpss-on-lisans-sinavi-brans-bazinda-siralamalar" } ] }Caveats
Verify dates on www.osym.gov.tr before acting on them — the calendar is the current year's and ÖSYM updates it through the year.
The announcements index serves one year per request; searching another year needs the
yearargument.Announcement bodies are Word-pasted HTML on the site; the tools return cleaned plain text.
Personal results (scores, rankings, placements) need a candidate login and are not covered.
Transport uses Chrome TLS impersonation with a plain-requests fallback; requests are spaced ~0.5s apart.
Development
python -m venv .venv && .venv/bin/pip install -e . pytest
.venv/bin/python -m pytest tests/test_parse.py -v # offline, recorded fixtures
.venv/bin/python -m pytest tests/test_live.py -v # live, against www.osym.gov.tr
.venv/bin/python tests/smoke_live.py # daily CI probeLicense
PolyForm Noncommercial 1.0.0 — free for personal and non-commercial use; commercial use needs a separate license.
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Unofficial access to CBRT/TCMB daily exchange rates: latest, history since 1996, conversion.
Read-only Istanbul open city data: transport, parking, water, nearby services and datasets.
Read-only search and retrieval for Official Translator's published guides.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to Turkish higher education data, enabling search and retrieval of detailed information about bachelor's and associate degree programs from universities across Turkey.MIT
- AlicenseBqualityBmaintenanceEnables users to query official undergraduate and graduate course schedules, indexes, prerequisites, and exam timetables, including tools for comparing indexes and finding matching schedules. It is read-only, local, and supports filtering by days, times, lesson types, teaching weeks, and schedule clashes.7211 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to search and read university web pages and PDF/Office documents, query live phone directory, food menu, academic calendar, announcements, and AKTS course plans, and return sourced answers with URLs and dates.MIT
- AlicenseAqualityBmaintenanceEnables read-only access to Turkish technology news and forum content, including latest articles, keyword search, full article text, section listings, and current hot forum topics.6MIT