get_bachelor_degree_atlas_details
Retrieve detailed information about specific bachelor's degree programs in Turkey, including statistics, quotas, placement data, and academic details using YÖP codes and year parameters.
Instructions
Get comprehensive details for a specific bachelor's degree program from YOKATLAS Atlas.
Parameters:
yop_kodu (str): Program YÖP code (e.g., '102210277')
year (int): Data year (e.g., 2024, 2023)
Returns detailed information including:
General program information and statistics
Quota, placement, and score data
Student demographics and distribution
Academic staff and facility information
Historical placement trends
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| yop_kodu | Yes | Program YÖP code (e.g., '102210277') - unique identifier for the bachelor's degree program | |
| year | Yes | Data year for statistics (e.g., 2024, 2023) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- yokatlas_mcp_server.py:62-87 (handler)Handler function implementing the tool logic for fetching bachelor's degree program details from YOKATLAS Atlas. Includes @mcp.tool() decorator for registration and Pydantic Field annotations for input schema validation.
@mcp.tool() async def get_bachelor_degree_atlas_details( yop_kodu: Annotated[str, Field(description="Program YÖP code (e.g., '102210277') - unique identifier for the bachelor's degree program")], year: Annotated[int, Field(description="Data year for statistics (e.g., 2024, 2023)", ge=2020, le=2030)] ) -> dict: """ Get comprehensive details for a specific bachelor's degree program from YOKATLAS Atlas. Parameters: - yop_kodu (str): Program YÖP code (e.g., '102210277') - year (int): Data year (e.g., 2024, 2023) Returns detailed information including: - General program information and statistics - Quota, placement, and score data - Student demographics and distribution - Academic staff and facility information - Historical placement trends """ try: lisans_atlasi = YOKATLASLisansAtlasi({'program_id': yop_kodu, 'year': year}) result = await lisans_atlasi.fetch_all_details() return result except Exception as e: print(f"Error in get_bachelor_degree_atlas_details: {e}") return {"error": str(e), "program_id": yop_kodu, "year": year} - yokatlas_mcp_server.py:62-62 (registration)Registration of the tool using FastMCP's @mcp.tool() decorator.
@mcp.tool() - yokatlas_mcp_server.py:64-66 (schema)Input schema defined using Annotated with Pydantic Field for parameter validation and descriptions.
yop_kodu: Annotated[str, Field(description="Program YÖP code (e.g., '102210277') - unique identifier for the bachelor's degree program")], year: Annotated[int, Field(description="Data year for statistics (e.g., 2024, 2023)", ge=2020, le=2030)] ) -> dict: