Aarth

List the connected user’s directly authorized library categories and recent items with titles, subjects, source details, and file or textbook metadata. Always pass action. Use list to browse; use open_textbook with a reference to open one textbook. Always use this first with action "list" and contentTypes=["textbook"] when the user asks to show or open “my textbook”, an English book, or a first chapter without already having an opaque reference. This works independently of optional unified Knowledge Layer search preferences. Never call this tool with empty arguments.

browse_my_library

List the connected user’s uploaded PDFs, documents, e-notes, and Library My Uploads with total count, folder details, and safe metadata, or open one in an interactive reader. Always pass action. Use list to browse (query optional); use open with a reference to open one file. Never call this tool with empty arguments. The reader privately renders PDFs/images and offers a signed download without exposing the URL to the model. A selectedDocument with isActive=true is the exact current file; answer follow-ups only from it and do not ask for another file unless the user requests a switch. For a vague request with no active document, call with action "list" and ask the exact clarification returned; never guess a file. After the user chooses, call again with action "open" and the selected opaque reference. A query may narrow the list by title, folder, subject, or filename.

open_uploaded_document

Browse playable audio lectures owned by the connected Aarth user, optionally narrowed by lecture, book, author, subject, or language, or open one in an interactive player using its opaque reference. Always pass action. Use list to browse (query optional); use open with a reference to open one lecture. Never call this tool with empty arguments. The MCP App receives the playback URL privately while Claude receives safe metadata and transcript context. A selectedLecture with isActive=true is the user’s exact current audio: answer follow-ups only from it and do not ask them to choose another audio unless they request a switch. For a vague request with no active lecture, call with action "list" and let the user select; never guess. When an active lecture and its transcript context are already present (from a player message or App context), the player is already open — answer follow-ups directly in plain text and do NOT call this tool again to answer, since re-opening restarts playback at 0:00. For detailed questions needing content beyond the provided excerpt, use get_academic_source with the active lecture reference to page through more transcript content.

play_audio_lecture

Read a specific source returned by an Aarth search or player tool, including notes, uploads, textbook passages, and lecture transcripts. Use the opaque reference exactly as returned. Continue with nextOffset when a source is longer than one response.

get_academic_source

Load the connected student’s safe personalization context: display name, education level, selected subjects, verified institute and classes, and pending tests or current assignments. Use this before personalized study planning or answering questions about the student’s class, institute, tests, assignments, or deadlines. It never returns email, phone, credentials, or database IDs.

get_my_student_context

Load a selected Aarth textbook chapter for the interactive reader. This compatibility tool is called by the reader interface and existing connector sessions.

open_textbook_reader

Open an Aarth academic textbook as an interactive, selectable PDF chapter reader. A returned reader with isActive=true is the exact current textbook chapter; answer follow-ups only from it and do not ask for another book or chapter unless the user requests a switch. Prefer the opaque reference returned by search_aarth_knowledge, search_academic_textbooks, search_my_library, or browse_my_library; it avoids title ambiguity. Select a returned chapter by title or zero-based index. Readable book metadata remains a tolerant compatibility fallback. Compatible MCP Apps hosts can select, copy, and ask AI about PDF passages inline; other hosts receive a cleaned text preview.

open_textbook

Search the connected student’s optional enabled Knowledge Layers across academic textbooks, verified school or university resources, and personal notes, uploads, flashcards, and lecture transcripts. Use this for educational questions, not for direct requests to list or open “my textbook”, “my notes”, “my uploads”, or “my library”; use the dedicated browse/open tool for those. A skipped layer does not mean the MCP connection or direct library authorization failed. It does not search the public web or current news.

search_aarth_knowledge

Search Aarth’s indexed academic textbook passages by concept or question. Optionally narrow by grade or subject, then fetch a matching chapter source.

search_academic_textbooks

Search the connected user’s directly authorized Aarth library, including saved textbooks, notes, flashcards, audio lecture transcripts, and uploaded academic documents. Use this for an exact title or source query; use browse_my_library when the user has not named an exact item.

search_my_library