YOKATLAS MCP

Overview

YOKATLAS MCP is a FastMCP server that provides programmatic access to YÖKATLAS (Higher Education Program Atlas) data. YÖKATLAS is Turkey's official university admission information system managed by YÖK (Council of Higher Education). It offers comprehensive search and detail viewing for undergraduate and associate degree programs.

Features

• Standard MCP Interface: Programmatic access to YÖKATLAS data
• Undergraduate Programs: 4-year university programs (Lisans)
• Associate Degree Programs: 2-year vocational school programs (Önlisans)
• Smart Search: Flexible search with fuzzy matching
• Claude Desktop Integration: Easy setup and usage

Installation

Quick Setup

# uv installation (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh

# uv installation (Windows PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Claude Desktop Configuration

{
  "mcpServers": {
    "YOKATLAS API": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/saidsurucu/yokatlas-mcp", "yokatlas-mcp"]
    }
  }
}

Usage Examples

• "Find Boğaziçi University computer engineering programs" - fuzzy matching demo
• "List all engineering programs in Istanbul" - partial matching
• "Get 2024 Atlas details for program code 102210277" - comprehensive statistics
• "Search for medical programs at public universities in Ankara" - location and institution type filter

Data Content

• Base Scores: YKS (Turkish University Entrance Exam) minimum and maximum scores
• Quotas: General and special quota information
• Enrolled Student Profile: Gender, city, high school type distributions
• Preference Statistics: Which preference choice students were placed with
• Success Rankings: Year-over-year ranking changes

License

MIT License