Quizlar

by quizlar

433 downloads
Not rated
GitHub

About

Quizlar is the learning MCP server. It turns whatever source the user brings — a YouTube lecture, a PDF, a URL, a textbook passage, or a pasted block of notes — into flashcards, then runs

Details

Author
quizlar
Downloads
433
Categories
Other

- Create flashcard decks from YouTube, PDFs, URLs, or text.
- Auto‑graded quizzes with exact‑match → phonetic → LLM grading.
- FSRS spaced repetition tracks real memory state per answer.
- 22 tools mapped 1:1 to learner verbs (ingest, quiz, review, manage).
- Bearer API key and OAuth 2.1 with PKCE authentication.
- Hosted server at mcp.quizlar.app (closed‑source; config repo is MIT).

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Quizlar
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Mint an API key at https://quizlar.app/settings/api-keys (format: sk-qz‑<32 chars>). Then configure your MCP client’s mcpServers to point to https://mcp.quizlar.app/mcp/ with Bearer token authentication. Cursor, Windsurf, Claude Desktop, Cline, and Smithery setup snippets are provided in the README. Windsurf supports Streamable HTTP natively; other clients use mcp-remote as a stdio wrapper.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "quizlar": {
            "quizlar": {
                "url": "https://mcp.quizlar.app/mcp/",
                "headers": {
                    "Authorization": "Bearer sk-qz-YOUR_API_KEY"
                }
            }
        }
    }
}

McpServers

{
    "quizlar": {
        "url": "https://mcp.quizlar.app/mcp/",
        "headers": {
            "Authorization": "Bearer sk-qz-YOUR_API_KEY"
        }
    }
}

Quizlar MCP Server

Voice-led, FSRS-scheduled flashcards from YouTube, PDFs, web, or text. Auto-graded quizzes.

Quizlar's MCP server lets Claude, Cursor, Cline, Windsurf, or any MCP-compatible client:

- Create flashcard decks from YouTube videos, PDFs, web pages, or pasted text
- Run auto-graded quizzes with the same tier-1-exact-match → phonetic → LLM grading pipeline that powers the voice product
- Track memory with FSRS spaced repetition — Quizlar is the scheduler of record, every answer updates real memory state

This 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/.

Listings

- Official MCP Registryio.github.quizlar/mcp-server v1.0.0
- Smithery — <https://smithery.ai/servers/quizlar/quizlar>

Setup

1. Mint an API key at <https://quizlar.app/settings/api-keys> (format: sk-qz-<32 chars>).
2. Pick your client below and paste the snippet.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "quizlar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.quizlar.app/mcp/",
        "--header",
        "Authorization:Bearer ${QUIZLAR_API_KEY}"
      ],
      "env": { "QUIZLAR_API_KEY": "sk-qz-..." }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — Windsurf supports Streamable HTTP natively, no wrapper needed:

{
  "mcpServers": {
    "quizlar": {
      "serverUrl": "https://mcp.quizlar.app/mcp/",
      "headers": { "Authorization": "Bearer ${QUIZLAR_API_KEY}" }
    }
  }
}

Then export QUIZLAR_API_KEY=sk-qz-... in your shell.

Claude Desktop

Open Settings → Connectors → "Add custom connector":

- Name: Quizlar
- URL: https://mcp.quizlar.app/mcp/
- Add header → Name: Authorization, Value: Bearer sk-qz-...

Or edit claude_desktop_config.json directly using mcp-remote:

{
  "mcpServers": {
    "quizlar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.quizlar.app/mcp/",
        "--header",
        "Authorization:Bearer ${QUIZLAR_API_KEY}"
      ],
      "env": { "QUIZLAR_API_KEY": "sk-qz-..." }
    }
  }
}

Cline

Edit cline_mcp_settings.json (Cline → Settings → MCP Servers → "Edit JSON"):

{
  "mcpServers": {
    "quizlar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.quizlar.app/mcp/",
        "--header",
        "Authorization:Bearer ${QUIZLAR_API_KEY}"
      ],
      "env": { "QUIZLAR_API_KEY": "sk-qz-..." }
    }
  }
}

Detailed steps in llms-install.md.

Smithery

npx -y @smithery/cli@latest install @quizlar/quizlar --client claude

Replace claude with cursor, windsurf, etc. Smithery walks you through pasting your API key.

Tools

22 tools mapped 1:1 to learner verbs:

- Ingest: create_deck_from_youtube, create_deck_from_pdf, create_deck_from_url, create_deck_from_text, import_shared_deck, get_job_status
- Quiz: quiz_me (composite: build + start in one call), start_quiz, next_card, submit_answer, end_quiz
- Review: get_study_recommendations, get_progress, get_streak, get_analytics
- Manage: list_decks, get_deck, update_deck, delete_deck, add_card, update_card, get_user_profile, update_preferences

Auth

Bearer API key (sk-qz-<32 chars>) is the simplest path and works in every client snippet above. Quizlar also exposes full OAuth 2.1 with Dynamic Client Registration + PKCE at https://mcp.quizlar.app/.well-known/oauth-authorization-server for clients that prefer a browser flow.

Links

- App: <https://quizlar.app>
- Issues: <https://github.com/quizlar/mcp-server/issues>
- Stdio bundle source: bundle/ (used to publish to Smithery + any other stdio-only client)

License

MIT for this configuration repo. The hosted MCP server itself is proprietary.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.