YokatlasSAFE
MCP Server for YOK Atlas
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Bu proje, YÖKATLAS verilerine erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, YÖKATLAS'tan lisans ve önlisans program arama ve detaylı istatistik getirme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya 5ire) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.
🎯 Temel Özellikler
- YÖKATLAS tercih kılavuzu JSON API'sine programatik erişim için standart bir MCP arayüzü.
- Aşağıdaki yetenekler:
- Birleşik Akıllı Arama: Lisans + önlisans tek arama; fuzzy matching ile üniversite/program/il adı çözümlemesi (örn: "boğaziçi" → "BOĞAZİÇİ ÜNİVERSİTESİ")
- 4 Yıllık İstatistik: Her programa ait kontenjan, yerleşen, taban puanı, başarı sırası, akademik kadro ve KPSS verileri tek seferde (current + 3 history)
- Net Sihirbazı: Son yerleşen kişinin ders bazında net sayıları (TYT/AYT/YDT), taban puan, OBP ve katsayı
- Lookup Araçları: Üniversite, program grubu ve il listelerine doğrudan erişim
- Filtreleme: Puan türü (SAY/SÖZ/EA/DİL/TYT), üniversite türü (DEVLET/VAKIF), başarı sırası aralığı, sayfalama ve sıralama
- Claude Desktop uygulaması ile
fastmcp installkomutu (veya manuel yapılandırma) kullanılarak kolay entegrasyon. - YOKATLAS MCP 5ire gibi Claude Desktop haricindeki MCP istemcilerini de destekler.
⚠️ v0.6.0 Breaking Change — YÖK Atlas Nisan 2026'da React tabanlı SPA'ya geçti, eski HTML scraping endpoint'leri ve detaylı atlas verileri (cinsiyet/lise alanı dağılımı, akademisyen ünvan dağılımı, KPSS yıllara göre, vb.) site genelinden kaldırıldı. Bu MCP yeni JSON API'ye karşı yazıldı; sadece resmî API'nin sunduğu temel istatistikler döner.
🚀 5 Dakikada Başla (Remote MCP)
✅ Kurulum Gerektirmez! Hemen Kullan!
796ed2368727OBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add yokatlas-mcp -- uvx yokatlas-mcp
{
"mcpServers": {
"yokatlas-mcp": {
"command": "uvx",
"args": [
"yokatlas-mcp"
]
}
}
}Exposed tools (3)
3 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
list_cities | read | |
list_program_groups | read | |
list_universities | read |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (1)
* **Mac/Linux Kullanıcıları (Terminal):** Bir Terminal ekranı açın ve bu kodu çalıştırın: `curl -LsSf https://astral.sh/uv/install.sh | sh`
Gates applied: no_behavioural_pass.
796ed2368727full audit observations/trust-audit/mcp-server/saidsurucu__yokatlas.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 796ed2368727 | SAFE | B | 89 | first audit |
Questions
What is the Yokatlas MCP server?
MCP Server for YOK Atlas
What tools does Yokatlas expose?
3 in total: 3 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Yokatlas safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Yokatlas need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (796ed2368727), read on 2026-10-07. The repository is watched and re-audited when it changes.