YOKATLAS

You can access YÖKATLAS data through a FastMCP server that exposes a standard MCP interface. This lets you search for programs, view detailed license and associate degree information, and filter results with an intelligent, model-friendly endpoint from Claude Desktop, 5ire, or other MCP clients.

How to use

You can connect to the YOKATLAS MCP server in two main ways: use the remote MCP URL directly from supported MCP clients, or run a local MCP client that talks to the server. You will be able to search for bachelor and associate degree programs, fetch detailed atlas information, and apply filters such as city, university type, tuition status, and education type. The server supports smart searching with fuzzy matching, so you can type partial names and still get the correct university or program.

How to install

Prerequisites: ensure you have a compatible MCP client or environment (Claude Desktop or another MCP client such as 5ire). If you want to use the remote MCP, you do not need to install anything locally for basic access.

Option A — Use the remote MCP directly with Claude Desktop (no local installation required): this lets you access YOKATLAS data from Claude Desktop immediately.

Option B — Set up a local MCP client (example using 5ire): follow these steps to run a local connector and point it at the YOKATLAS MCP server.

Python 3.12 is required. Install Python with the standard installer and ensure the option Add Python to PATH is selected.
Git for Windows (if you are on Windows) or your OS package manager to install Git.
Install uv (the universal verifier) per the platform instructions.
On Windows, install Microsoft Visual C++ Redistributable if you encounter Python package issues.
Install the 5ire MCP client for your OS and workspace.
Open 5ire and provide your API keys for the LLM service you plan to use under Workspace -> Providers.

Tool setup for 5ire to access YOKATLAS MCP

Usage with Claude Desktop (remote MCP)

Open Claude Desktop and follow these steps to connect to the remote MCP server.

1. Claude Desktop → Settings → Connectors → Add Custom Connector.

2. Enter the following information.

Name: YOKATLAS MCP

URL: https://yokatlasmcp.fastmcp.app/mcp

3. Click Add and start using YOKATLAS MCP immediately.

Configuring via raw MCP store (optional)

If you want to view or share a raw MCP config for your client, you can add a configuration that points to the remote endpoint.

Code sample (MCP store configuration) is shown for reference in the workflow.

{"mcpServers": {"yokatlas-mcp": {"serverUrl": "https://yokatlasmcp.fastmcp.app/mcp/", "headers": {"Content-Type": "application/json"}}}}

Claude Antigravity usage (no local setup required)

If you use Claude’s agents, you can add the remote MCP server under the MCP Stores and then view or import the YOKATLAS MCP configuration.

Steps to add the remote MCP server in Claude Antigravity UI are described in the setup flow, enabling you to query YOKATLAS data directly from Claude.

Available tools

search_bachelor_degree_programs

Smart search for bachelor degree programs using fuzzy matching to match partial names and provide relevant results. Parameters include university, program, city, score_type, university_type, fee_type, education_type, availability, and results_limit.

search_associate_degree_programs

Smart search for associate degree programs with fuzzy matching and partial matching support. Parameters include university, program, city, university_type, fee_type, education_type, availability, and results_limit.

get_bachelor_degree_atlas_details

Fetch comprehensive details for a specific bachelor degree program by yop_kodu and year, returning quota, admission scores, demographics, faculty, and facilities.

get_associate_degree_atlas_details

Fetch comprehensive details for a specific associate degree program by yop_kodu and year, returning quota, admission data, student distribution, and faculty.