{"$schema":"https://schemas.modelcontextprotocol.io/server-card/v1.json","name":"notapex-mcp-server","displayName":"Notapex — Study Notes & AI Study Tools","description":"Official Model Context Protocol (MCP) server for Notapex (https://notapex.com). Search verified academic & competitive exam study notes, read structured transcripts, explore creator channels, check pricing plans, and convert handwritten notebooks into structured PDFs or editable PowerPoint decks.","version":"1.2.0","icon":"https://notapex.com/images/NotaPexLogo.png","logo":"https://notapex.com/images/NotaPexLogo.png","homepage":"https://notapex.com","documentationUrl":"https://notapex.com/docs","serverUrl":"https://notapex.com/mcp","docsServerUrl":"https://notapex.com/mcp/docs","transport":{"type":"streamable-http","url":"https://notapex.com/mcp","supportedProtocols":["2025-03-26","2024-11-05"]},"authentication":{"type":"oauth2","required":false,"publicReadAccess":true,"authorizationServerMetadataUrl":"https://notapex.com/.well-known/oauth-authorization-server","protectedResourceMetadataUrl":"https://notapex.com/.well-known/oauth-protected-resource","registrationEndpoint":"https://notapex.com/api/oauth/register","codeChallengeMethodsSupported":["S256"],"scopesSupported":["notes:read","notes:write","notes:convert","channels:read","account:read","webhooks:manage"]},"capabilities":{"tools":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"prompts":{"listChanged":false},"experimental":{"mcpApps":{"supported":true,"views":["ui://notapex/note-viewer","https://notapex.com/mcp/view/note-viewer"]}}},"tools":[{"name":"search_notes","title":"Search Published Study Notes","description":"Search and filter verified academic and competitive exam study notes on Notapex (JEE, NEET, UPSC, SSC, GATE, Computer Science, Mathematics) by keyword query and category slug. Returns cursor-paginated note summaries, page counts, pricing in INR, and direct URLs.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword search query matching note title, subject, exam name, or summary (e.g., \"graph theory\", \"organic chemistry\", \"polity\")."},"category":{"type":"string","description":"Optional category slug filter (e.g., \"computer-science\", \"jee-neet\", \"upsc\", \"ssc-railways\", \"mathematics\")."},"limit":{"type":"integer","description":"Maximum number of study notes to return (1-50, default 10).","minimum":1,"maximum":50,"default":10}},"required":["query"],"additionalProperties":false},"annotations":{"title":"Search Published Study Notes","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"ui":{"resourceUri":"ui://notapex/note-viewer","viewUrl":"https://notapex.com/mcp/view/note-viewer"}}},{"name":"get_note","title":"Get Study Note Details & Transcript Preview","description":"Retrieve comprehensive metadata, page count, author details, pricing, and structured transcript summary for a specific study note on Notapex using its unique slug or ID.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Unique URL slug or identifier of the study note (e.g., \"unit-4-graph-theory-terminology-and-paths\")."}},"required":["slug"],"additionalProperties":false},"annotations":{"title":"Get Study Note Details","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"ui":{"resourceUri":"ui://notapex/note-viewer","viewUrl":"https://notapex.com/mcp/view/note-viewer"}}},{"name":"list_categories","title":"List Academic Subjects & Exam Categories","description":"List all available academic disciplines and competitive exam categories on Notapex, including supported exam tracks (UPSC, JEE, NEET, SSC, GATE, University Exams) and published note counts.","inputSchema":{"type":"object","properties":{"exam_filter":{"type":"string","description":"Optional filter for exam type (e.g., \"GATE\", \"JEE\", \"UPSC\", \"SSC\")."}},"required":[],"additionalProperties":false},"annotations":{"title":"List Exam Categories","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_note_conversion","title":"Convert Handwritten Notes to Structured PDF or PPTX","description":"Submit a handwritten notebook PDF, scanned image (JPG/PNG), or typed DOCX document to the Notapex AI Note Converter or AI Presentation Maker. Returns an asynchronous job ID and status polling URL. Supports non-destructive sandbox mode for testing.","inputSchema":{"type":"object","properties":{"source_url":{"type":"string","description":"Publicly reachable HTTPS URL of the source PDF, image, or DOCX file to convert."},"mode":{"type":"string","enum":["faithful_exact_copy","structured_study_notes","ppt_presentation"],"description":"Conversion mode: \"faithful_exact_copy\" preserves exact words with clean Markdown/LaTeX/Mermaid formatting; \"structured_study_notes\" creates revision notes; \"ppt_presentation\" generates an editable PowerPoint deck."},"sandbox":{"type":"boolean","description":"Set to true (default) to run in safe sandbox test mode without consuming user credits.","default":true}},"required":["source_url","mode"],"additionalProperties":false},"annotations":{"title":"Start AI Note Conversion Job","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_conversion_status","title":"Check Asynchronous Conversion Job Status","description":"Poll the status, progress percentage (0-100), and output download URL of an asynchronous AI note conversion or PowerPoint generation job created via create_note_conversion.","inputSchema":{"type":"object","properties":{"job_id":{"type":"string","description":"Unique job identifier returned by create_note_conversion (e.g., \"job_sample123\")."}},"required":["job_id"],"additionalProperties":false},"annotations":{"title":"Check Conversion Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_pricing_plans","title":"Get Notapex Pricing & AI Credit Packages","description":"Retrieve machine-readable pricing tiers, free starter tier allowances, prepaid credit packages in INR, validity periods, and included AI Note Converter and Marketplace features.","inputSchema":{"type":"object","properties":{"currency":{"type":"string","description":"Preferred currency code (default \"INR\").","default":"INR"}},"required":[],"additionalProperties":false},"annotations":{"title":"Get Pricing Plans","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search_docs","title":"Search Notapex Developer & API Documentation","description":"Query the Notapex developer documentation, OpenAPI 3.1 endpoints, OAuth 2.0 + PKCE authentication flows, named scopes, and MCP integration instructions.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Documentation topic or keyword to search for (e.g., \"oauth scopes\", \"pagination\", \"conversion webhook\", \"rate limits\")."}},"required":["query"],"additionalProperties":false},"annotations":{"title":"Search Developer Docs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}],"resources":[{"uri":"ui://notapex/note-viewer","name":"Notapex Interactive Study Note Viewer","description":"Interactive MCP App HTML view for rendering study note summaries, LaTeX equations, and metadata inside ChatGPT and Claude.","mimeType":"text/html;profile=mcp-app"},{"uri":"notapex://docs/overview","name":"Notapex Platform & Agent Integration Overview","description":"Comprehensive Markdown overview of Notapex capabilities, when to use Notapex, public REST API v1, and MCP server tools.","mimeType":"text/markdown"},{"uri":"notapex://docs/api-reference","name":"Notapex Public REST API v1 & OAuth 2.0 Reference","description":"Machine-readable API endpoint guide covering /api/v1/notes, /api/v1/conversions, OAuth 2.0 PKCE S256, and named scopes.","mimeType":"text/markdown"},{"uri":"notapex://pricing/plans","name":"Notapex Pricing Tiers & Credit Model","description":"Structured Markdown summary of Notapex free tier and prepaid credit packs in INR.","mimeType":"text/markdown"}],"prompts":[{"name":"find_exam_notes","description":"Find verified study notes and revision guides for a specific academic subject or competitive exam.","arguments":[{"name":"subject","description":"Academic topic or competitive exam name (e.g., \"Graph Theory\", \"UPSC Polity\", \"JEE Organic Chemistry\").","required":true}]},{"name":"convert_handwritten_pdf","description":"Convert a handwritten notebook PDF or image into a clean, structured study PDF preserving exact wording.","arguments":[{"name":"source_url","description":"HTTPS URL of the handwritten PDF or image.","required":true}]}]}