List provinces (il) used by YOK ATLAS to filter university preference searches. Optionally filter by a case-insensitive substring of the province name and/or cap the number of results. Returns a standard envelope: {ok, data, error, disclaimer}.

List universities in the YOK ATLAS preference guide. Optionally filter by a case-insensitive substring of the university name and/or cap the number of results. Returns a standard envelope: {ok, data, error, disclaimer}.

List YOK ATLAS program groups (birim grup), e.g. 'Bilgisayar Muhendisligi', each tagged with its exam score type (SAY, EA, SOZ/SÖZ, DIL/DİL, or TYT). Optionally filter by a case-insensitive substring of the program name, a score type (ASCII spellings like SOZ/DIL are accepted), and/or cap the number of results. Returns a standard envelope: {ok, data, error, disclaimer}.

Search YOK ATLAS program placements -- the core preference-search endpoint. university_ids, program_group_ids, and city_codes must be resolved first via get_universities, get_university_programs, and get_university_cities respectively (this tool does not do its own name lookups). Returns each matching placement's university, program, quota, fee, scholarship, and the prior guide's minimum success rank / score cutoff, paginated. Returns a standard envelope: {ok, data, error, disclaimer}.