Skip to main content
Glama
emirks

YOKATLAS MCP Server

by emirks
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Related MCP server: İhale MCP

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!

  1. Development:

    npm run dev

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • YOKATLAS API MCP Server

    saidsurucu
    A
    license
    A
    quality
    C
    maintenance
    Provides an MCP interface for accessing YOKATLAS (Turkish Higher Education Council Atlas) data, enabling LLM applications like Claude to search and retrieve details about undergraduate and associate degree programs in Turkey.
    4
    71
    MIT

  • İhale MCP

    saidsurucu
    A
    license
    A
    quality
    B
    maintenance
    Enables users to search and access Turkish public procurement data from EKAP v2 portal. Provides comprehensive tender search, detailed tender information, announcements, and authority/classification code lookups through natural language interactions.
    12
    102
    MIT

  • YokTez MCP

    saidsurucu
    A
    license
    A
    quality
    F
    maintenance
    Enables searching the YÖK National Thesis Center and retrieving thesis contents in Markdown format for LLM applications. It allows users to perform detailed searches based on criteria like author, university, and subject while providing programmatic access to thesis metadata and PDF content.
    6
    130
    MIT