YOKATLAS MCP Server
🚀 Live Deployment on Smithery | 🌐 Tercihify Website
TypeScript MCP wrapper for the yokatlas-py package, providing access to Turkish higher education data through Model Context Protocol.
Features
- Bachelor's Degree Search - Smart fuzzy search for 4-year university programs
- Associate Degree Search - Search for 2-year college programs
- Program Details - Get comprehensive information for specific programs
- Health Check - Server status and availability monitoring
Requirements
- Node.js 18+ (handled by Smithery runtime)
- Python 3.8+ (automatically installed during deployment)
- npm (for local development)
Setup
Local Development
- Install dependencies:
bash npm ci pip install -r requirements.txt
Smithery Deployment
Uses Custom Deploy with a custom Dockerfile for full control over the build environment. Dependencies are automatically installed during Docker build - no manual setup required!
-
Development:
bash npm run dev -
Deploy:
bash npm run deploy
MCP Tools
search_bachelor_degree_programs
Search 4-year university programs with fuzzy matching.
Parameters:
- universite - University name (fuzzy matching)
- program - Program/department name
- sehir - City name
- puan_turu - Score type: SAY, EA, SOZ, DIL
- universite_turu - University type: Devlet, Vakıf, KKTC, Yurt Dışı
- ucret - Fee status: Ücretsiz, Ücretli, Burslu, etc.
- ogretim_turu - Education type: Örgün, İkinci, Açıköğretim, Uzaktan
search_associate_degree_programs
Search 2-year college programs.
Parameters:
- university - University name (fuzzy matching)
- program - Program name
- city - City name
- university_type - University type
- fee_type - Fee status
- education_type - Education type
get_bachelor_degree_atlas_details
Get detailed information for a specific bachelor's program.
Parameters:
- yop_kodu - Program YÖP code (e.g., "102210277")
- year - Data year (e.g., 2024)
get_associate_degree_atlas_details
Get detailed information for a specific associate degree program.
Parameters:
- yop_kodu - Program YÖP code (e.g., "120910060")
- year - Data year (e.g., 2024)
health_check
Verify server status and yokatlas-py availability.
Tech Stack
- TypeScript - MCP server implementation
- Python - yokatlas-py package runner
- Smithery SDK - MCP TypeScript framework
- Zod - Schema validation
License
MIT