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:
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:
npm run dev -
Deploy:
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 namesehir- City namepuan_turu- Score type: SAY, EA, SOZ, DILuniversite_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 namecity- City nameuniversity_type- University typefee_type- Fee statuseducation_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