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

1. 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!

2. Development:

   npm run dev

3. 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 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