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)

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:

YOKATLAS API MCP Server