PRIORITY 1 — Semantic search across the pre-indexed Materio document library.

Uses Google Gemini (gemini-embedding-2-preview) to match your question against extracted textbook chunks stored in a vector database. Always call this first before attempting fetch_pdf. Returns the most relevant text passages with similarity scores and source page references.

Args:

• query (string): The specific question, concept, or topic to search for. Be precise — e.g. "deadlock detection algorithm" not just "deadlock".

• semester (string, optional): Filter results to a specific semester (e.g. "4").

• subject (string, optional): Filter results to a specific subject (e.g. "Operating System").

• limit (number, optional): Number of results to return (default: 5, max: 15).

Returns: Ranked text chunks with similarity %, subject, topic, page range, and a direct PDF link for further reading.

Examples:

• "Explain banker's algorithm" → params: { query: "banker algorithm deadlock avoidance" }

• "OS deadlocks semester 4" → params: { query: "deadlock", semester: "4", subject: "Operating System" }

List all available educational resources in the Materio library.

Returns a structured overview of all semesters, subjects, resource categories, and topics available. Use this to discover what PDFs are available before fetching a specific one.

Optionally filter by semester number to narrow results.

Args:

• semester (string, optional): Filter by semester number (e.g. "1", "2", "3", "4", "5", "6"). Omit to list all semesters.

Returns: A formatted markdown listing of all available resources organized by semester > subject > category > topics.

Examples:

• "What subjects are in semester 3?" → params: { semester: "3" }

• "Show me all resources" → params: {}

• "What's available for semester 5?" → params: { semester: "5" }

Search across all Materio educational PDFs by keyword.

Searches through semester numbers, subject names, category types (Chapters, Assignments, Question Banks, etc.), and topic names to find matching resources.

Args:

• query (string): Search keywords to match, e.g. "operating system deadlocks", "maths laplace", "java inheritance", "question bank", "semester 4". Multiple words narrow the search.

• limit (number, optional): Maximum number of results to return (default: 20, max: 50).

Returns: A list of matching resources with semester, subject, category, topic name, and the CDN URL for each PDF.

Examples:

• "Find notes on deadlocks" → params: { query: "deadlocks" }

• "Question banks for semester 4" → params: { query: "question bank semester 4" }

• "Java chapters" → params: { query: "java chapters" }

• "DBMS SQL" → params: { query: "dbms sql" }

• "Maths Laplace Transform" → params: { query: "laplace transform" }

Fetch and read the full text content of a Materio PDF.

Downloads the PDF from the Materio CDN and extracts its text content so you can read and reason over it. Use this after searching/browsing to retrieve the actual study material.

You can provide EITHER a direct PDF URL (from a search result) OR the semester + subject + topic combination.

IMPORTANT: This tool is designed to help users study. When answering questions based on PDF content:

• Use the PDF's own terminology and definitions

• Cover all relevant points as expected in university exams

• Structure answers clearly with proper headings

• Include examples from the material when available

Args:

• url (string, optional): Direct CDN URL of the PDF. If provided, semester/subject/topic are ignored.

• semester (string, optional): Semester number (e.g. "1", "2", "3", "4", "5", "6"). Required if url is not provided.

• subject (string, optional): Subject name exactly as listed in the resource library. Required if url is not provided.

• topic (string, optional): Topic name exactly as listed in the resource library. Required if url is not provided.

Returns: The full extracted text content of the PDF, which may be long. The AI can then use this to answer questions.

Examples:

• Fetch by URL: { url: "https://cdn-materioa.vercel.app/pdfs/4/Operating%20System/Deadlocks.pdf" }

• Fetch by path: { semester: "4", subject: "Operating System", topic: "Deadlocks" }

• Fetch by path: { semester: "3", subject: "Object Oriented Programming with Java", topic: "Inheritance" }

Get a professional masked share link for a Materio PDF.

This returns a secure URL (e.g., materias.vercel.app/?share=...) that opens the PDF beautifully in the Materio viewer. Use this when finalizing a study session or providing resources to the user.

Takes EITHER a raw CDN 'url' OR 'semester, subject, topic'.

Get a complete overview of all available resources for a specific subject.

Shows all categories (Chapters, Assignments, Question Banks, Previous Year Papers, etc.) and their topics for the given subject. Useful for understanding the full scope of available material before diving into specific topics.

Args:

• semester (string): Semester number (e.g. "1", "2", "3", "4", "5", "6").

• subject (string): Subject name exactly as listed in the resource library.

Returns: A detailed listing of all resource categories and topics for the subject, with PDF URLs for each.

Examples:

• { semester: "4", subject: "Operating System" }

• { semester: "2", subject: "Maths-2" }

• { semester: "3", subject: "Database Management Systems" }