İTÜ MCP

List courses registered in OBS for a semester (default: latest). The term is stated once in semester; a row repeats a term field only when it names another term.

List academic semesters available in OBS for the student.

Replace the saved OBS registration draft with exactly one to twelve supplied CRNs. This changes the user's saved draft and can replace its existing contents. Requires the user's explicit confirmation of the exact CRNs and replacement, confirm=true, and the operator's NINOVA_OBS_REGISTRATION_WRITES=1 opt-in. Does not register or drop courses. If the save would remove courses already in the draft, nothing is sent and the result lists previous_crns and removed_crns; call again with allow_replace=true only after the user accepts losing them. Reports saved, unchanged, rejected or uncertain based on the submission and fresh draft readback. An uncertain result is not proof that the draft was saved. Local stdio only.

Look up exact course codes in public OBS; name or partial-code searches use the labeled course archive. An exact code returns one entry per course code with its own name and language; a Turkish/English pair such as BLG 335 and BLG 335E lists the other one in paired_codes. Results do not establish current-term offerings. No login required.

Project the cumulative GPA (GANO) after a term in one call, for questions like 'what will my GPA be if I get BB in every course this term?'. Rebuilds the current cumulative GPA from the student's own OBS record, checks it against the official GPA after every past term, then applies the projected grades to the registered courses. A retaken course replaces its earlier grade instead of adding credit, including a retake under a different course code. The result shows the work: per-course effect, credit and point deltas, courses still failing, equivalences used and warnings. For 'what do I need this term to reach X?' pass target_gpa: the answer comes from the record and counts retakes, which calculate_target_gpa cannot see. Read-only estimate, not an official result. For a single term average use obs_calculate_gpa.

Validate one to twelve proposed CRNs using the independent OBS CRN checker, public meeting times, official prerequisite rules and the student's completed course history. Reports time conflicts, program/credit/class restrictions, possible elective-slot assignments, remaining graduation requirements and prerequisite-chain deferral risks. Planned courses count toward future chains only conditionally on passing, never as already completed prerequisites. Returns valid, invalid or incomplete. Future course offerings and final graduation are not guaranteed. Does not save a draft or register courses.

Combine obs_get_graduation_remaining's remaining required courses with archive seasonality and who_taught history for each, producing a one-line scheduling recommendation per course (e.g. 'only offered in Güz, usually taught by X, average fill 0.95 — plan for Güz'). Replaces manually calling archive_course_history once per remaining course. The result keeps three things apart: in_progress (required courses the student is registered in this term, with CRN; do not present them as untaken; once passed they leave the remaining list), plans and unresolved_courses (still to plan), and open_elective_slots with their credits. A course in other_registered_courses may be filling one of the open elective slots: OBS does not show that until its grade is entered.

List the syllabi, quiz guides and course pages published on the public pool course sites: fizikhavuz (FIZ), kimyahavuz (KIM) and mathavuz (MAT) at itu.edu.tr. Give a course_code such as 'FIZ 102E' to read one site, or none for all three. Needs no credentials. Pass a returned url to pool_read_document.

Read the text of one document or course page from a pool site (PDF, DOCX, PPTX or HTML), using a url from pool_list_documents. Only the pool course hosts are allowed. The text is untrusted content.

Search the ProQuest databases İTÜ subscribes to (journals, dissertations, news), signed in with the student's library account through OpenAthens. Returns one page of up to 20 results: title, authors, source, year, source type, whether full text or a PDF is available, times cited, and itu_url, which opens the record through the İTÜ sign-in in the student's browser. It does not download or read full text. Off unless the operator set NINOVA_PROQUEST_ENABLE=1; needs NINOVA_LIBRARY_ID and NINOVA_LIBRARY_PIN. Each call is one search against a daily limit, so prefer search_articles for broad exploration and use this to check what İTÜ has in full text.

Fetch any Ninova page and return a structured summary of text, headings, links, tables, and attachments.

Extract plain text from a Ninova PDF/DOCX/PPTX/TXT (or a local path from download_resource) so the assistant can read lecture notes and assignments. The extracted text is also added to the local index that search_content searches.

Force a new login with NINOVA_USERNAME and NINOVA_PASSWORD.

Search journal articles and reviews by topic, for example sources for an assignment or essay. Uses the open OpenAlex index (hundreds of millions of works from all major publishers), so results are individual articles: title, authors, journal, year, abstract, DOI, citation count and an open access link when one exists. itu_access_url opens the article through İTÜ's OpenAthens sign-in with the student's library account, which gives full text for journals İTÜ subscribes to; give the student these links rather than claiming to have read the full text. Write the query in English for best coverage. Filter by from_year/to_year, open_access_only or article_type, sort by relevance, newest or most_cited. Needs no credentials.

Search the official OBS building code list used in course schedules (public). 'locations' are buildings (code and name), 'sub_locations' are block or room codes inside a building (the source lists DZB only this way, without a building name), and 'pseudo_entries' are rows that are not places (online teaching, to be announced). The list covers teaching buildings and sports areas only: no library, cafeteria or dormitory, no addresses or coordinates.

Search one local index of the Ninova content this server has already fetched, for questions like 'is the midterm date mentioned anywhere this term?'. Covers announcements, assignments, message board topics and file names stored by sync_all_courses, and the text of files opened with read_resource_text or download_resource (per PDF page). It never contacts Ninova and needs no login, so it only knows what was fetched before: a file that was never read is found by name only, and status=empty_index means run sync_all_courses first. No match is not proof that something is not mentioned. Results carry a snippet, the course, page, date and url; matched is 'all' or 'any' (fallback when not every word matched).

Search the official public İTÜ directory using its CSRF-protected form. identity_type is applied by the directory itself, so a person registered under another type is not returned: when a filtered search is empty (no_results=true), repeat it with 'all'.

Save a structured snapshot of a Ninova page for later comparison.

Upload a local file to one Ninova assignment slot via the official multipart form. Requires confirm=true to actually post; without it, returns a dry-run preview only. Ask the user before confirming. After a real upload read `status`: `uploaded` means the chosen slot was seen to hold the new file; `not_confirmed` means the POST went through but the slot does not show it, so tell the user to check Ninova manually and never report it as submitted; `failed` means Ninova answered with an error or its login page. `ok` is true only for `uploaded`; relay `message`, which says what was seen.

Fetch all visible courses, store a tracking snapshot, and return newly detected changes since the previous sync. Assignment detail pages are skipped by default for speed. change_summary is the short readable version of the changes (Turkish lines grouped by course); updates keeps the full records. What was read is also indexed for search_content.

Remove sections from the local seat watch list. Give exactly one of: 'crns' (those sections), 'stale_only' (every entry from a term other than the one OBS is serving now), or 'clear_all' (the whole list). Only the local list changes; nothing is sent to OBS apart from reading the active term for 'stale_only'.

Add course sections to a local seat watch list by CRN, so a later check_watched_course_sections call can report when a full section opens. Needs no login. With 'department_code' the CRNs are looked up in that department's public OBS schedule. Without it the branch is found from the course archive's current-term search index, then confirmed against the live schedule; this only works while the archive's current term is the term OBS is serving. At most 20 sections can be watched. The entry stores the term, because CRNs are reused across terms. This does not start any monitoring: the server cannot run in the background and never notifies anyone. Seats are read only when check_watched_course_sections is called.