[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@quizlar/mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":57,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","quizlar","moduleId","mcp-server","@quizlar/mcp-server","displayName","Quizlar — voice-powered AI flashcards with spaced repetition","tagline","Voice-led, FSRS-scheduled flashcards from YouTube, PDFs, web, or text. Auto-graded quizzes.","iconKey","https://avatars.githubusercontent.com/u/92644521?v=4","category","communication","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.quizlar.app/mcp/\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363654000,"updatedAt",1781412645000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.quizlar%2Fmcp-server","sourceVerified",true,"importedAt","upstreamStars",0,"upstreamUpdatedAt",1779388250000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/quizlar/mcp-server","githubRepoFullName","quizlar/mcp-server","releaseId","ext-quizlar-mcp-server","version","1.0.0","descriptionMarkdown","# Quizlar MCP Server\n\nVoice-led, FSRS-scheduled flashcards from YouTube, PDFs, web, or text. Auto-graded quizzes.\n\nQuizlar's MCP server lets Claude, Cursor, Cline, Windsurf, or any MCP-compatible client:\n\n- Create flashcard decks from YouTube videos, PDFs, web pages, or pasted text\n- Run auto-graded quizzes with the same tier-1-exact-match → phonetic → LLM grading pipeline that powers the [voice product](https://quizlar.app)\n- Track memory with FSRS spaced repetition — Quizlar is the scheduler of record, every answer updates real memory state\n\nThis repo is the public discovery surface (`server.json` for the Official MCP Registry + a stdio bundle for clients that need it). The hosted MCP server itself is closed-source and runs at `https://mcp.quizlar.app` — `/mcp/` for OAuth-capable clients, `/mcp-apikey/` for apiKey Bearer auth (used by every snippet in this README).\n\n## Listings\n\n- **Official MCP Registry** — `io.github.quizlar/mcp-server` v1.0.0\n- **Smithery** — \n\n## Setup\n\n1. **Mint an API key** at (format: `sk-qz-<32 chars>`).\n2. **Pick your client below** and paste the snippet.\n\n### Cursor\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"quizlar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.quizlar.app/mcp-apikey/\",\n \"--header\",\n \"Authorization:Bearer ${QUIZLAR_API_KEY}\"\n ],\n \"env\": { \"QUIZLAR_API_KEY\": \"sk-qz-...\" }\n }\n }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json` — Windsurf supports Streamable HTTP natively, no wrapper needed:\n\n```json\n{\n \"mcpServers\": {\n \"quizlar\": {\n \"serverUrl\": \"https://mcp.quizlar.app/mcp-apikey/\",\n \"headers\": { \"Authorization\": \"Bearer ${QUIZLAR_API_KEY}\" }\n }\n }\n}\n```\n\nThen `export QUIZLAR_API_KEY=sk-qz-...` in your shell.\n\n### Claude Desktop\n\nOpen Settings → Connectors → \"Add custom connector\":\n\n- **Name:** Quizlar\n- **URL:** `https://mcp.quizlar.app/mcp-apikey/`\n- Add header → **Name:** `Authorization`, **Value:** `Bearer sk-qz-...`\n\nOr edit `claude_desktop_config.json` directly using `mcp-remote`:\n\n```json\n{\n \"mcpServers\": {\n \"quizlar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.quizlar.app/mcp-apikey/\",\n \"--header\",\n \"Authorization:Bearer ${QUIZLAR_API_KEY}\"\n ],\n \"env\": { \"QUIZLAR_API_KEY\": \"sk-qz-...\" }\n }\n }\n}\n```\n\n### Cline\n\nEdit `cline_mcp_settings.json` (Cline → Settings → MCP Servers → \"Edit JSON\"):\n\n```json\n{\n \"mcpServers\": {\n \"quizlar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.quizlar.app/mcp-apikey/\",\n \"--header\",\n \"Authorization:Bearer ${QUIZLAR_API_KEY}\"\n ],\n \"env\": { \"QUIZLAR_API_KEY\": \"sk-qz-...\" }\n }\n }\n}\n```\n\nDetailed steps in [`llms-install.md`](https://github.com/quizlar/mcp-server/blob/main/llms-install.md).\n\n### Smithery\n\n```sh\nnpx -y @smithery/cli@latest install @quizlar/quizlar --client claude\n```\n\nReplace `claude` with `cursor`, `windsurf`, etc. Smithery walks you through pasting your API key.\n\n## Tools\n\n22 tools mapped 1:1 to learner verbs:\n\n- **Build decks:** `create_deck`, `create_deck_from_text`, `create_deck_from_youtube`, `create_cards_batch`, `get_job_status`\n- **Quiz:** `quiz_me` (composite: build + start in one call), `start_quiz`, `submit_answer`, `skip_question`, `end_quiz`\n- **Browse:** `list_decks`, `get_deck`, `list_cards`, `search_decks`, `search_cards`, `list_sessions`\n- **Analytics:** `get_progress`, `get_study_recommendations`, `get_learning_velocity`, `get_knowledge_gaps`, `get_retention_curves`, `get_card_difficulty_stats`\n\n## Auth\n\nBearer API key (`sk-qz-<32 chars>`) is the simplest path; the `/mcp-apikey/` mount used in every snippet above accepts the Bearer header directly and skips the OAuth handshake that some stdio bridges can't drive. Quizlar also exposes full OAuth 2.1 with Dynamic Client Registration + PKCE on `https://mcp.quizlar.app/mcp/` (discovery card at `/.well-known/oauth-authorization-server`) for clients that prefer a browser flow.\n\n## Troubleshooting\n\n- **`401 Unauthorized` on every tool call** — API key is missing, mistyped, or revoked. Re-mint at and paste the full `sk-qz-…` value, including the prefix, into the `Authorization: Bearer …` header.\n- **Client doesn't see Quizlar tools after editing config** — fully restart the client (most don't hot-reload MCP config). For Claude Desktop, quit from the menu bar; for Cursor / Windsurf / Cline, close all windows.\n- **`mcp-remote` fails to launch** — usually a Node.js / `npx` path issue. Run `npx -y mcp-remote --help` in a terminal to verify it resolves; if behind a corporate proxy, set `HTTPS_PROXY` in the client's `env` block or install `mcp-remote` globally with `npm i -g mcp-remote`.\n- **`429` / quota errors mid-quiz** — free-tier daily limits reached. Quotas reset at midnight UTC; or upgrade at .\n- **OAuth callback never returns to the client** — your loopback port may be blocked. Fall back to the API-key flow above; it bypasses OAuth entirely.\n\nFor anything not covered here, file an issue at or email .\n\n## Links\n\n- **App:** \n- **Issues:** \n- **Stdio bundle source:** [`bundle/`](https://github.com/quizlar/mcp-server/blob/main/bundle/) (used to publish to Smithery + any other stdio-only client)\n\n## License\n\nMIT for this configuration repo. The hosted MCP server itself is proprietary.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","Communication","upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":103},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","JavaScript","registryName","io.github.quizlar/mcp-server","homepage","https://quizlar.app","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]