1. Conduid
  2. Documentation
  3. YOKATLAS MCP Server
MCP server · Documentation

YOKATLAS MCP Server

by · github.com/emirks/yokatlas-mcp-typescript

Yök Atlas MCP

Unclaimed last commit a year ago docs
InstallView source
34Low

Scored a month ago · breakdown

About YOKATLAS MCP Server

YOKATLAS MCP Server is an MCP server published by emirks in the Documentation category: yök Atlas MCP.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/emirks/yokatlas-mcp-typescript

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (5)

get_associate_degree_atlas_detailsGet comprehensive details for a specific associate degree program from YOKATLAS Atlas

Parameters not published.

get_bachelor_degree_atlas_detailsGet comprehensive details for a specific bachelor

Parameters not published.

health_checkCheck the health and capabilities of the YOKATLAS server, including search method and data availability

Parameters not published.

search_associate_degree_programsSearch for associate degree (önlisans) programs using LOCAL DATA with instant results, smart fuzzy matching, and bell curve sampling for large result sets

Parameters not published.

search_bachelor_degree_programsSearch for bachelor

Parameters not published.

Ask AI

✦

Ask AI about YOKATLAS MCP Server

Powered by Claude · Grounded in docs

I know everything about YOKATLAS MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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!

  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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About YOKATLAS MCP Server

How do I install YOKATLAS MCP Server?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is YOKATLAS MCP Server safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is YOKATLAS MCP Server still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.