QuizbySwitch-to.eu

MCP Integration

Create and manage quizzes directly from AI assistants like Claude, Cursor, and other MCP-compatible tools.

AI-PoweredEnd-to-End EncryptedOpen Protocol

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and services. Quiz exposes an MCP endpoint that allows AI agents to create quizzes, add and edit questions, and manage the full quiz lifecycle — all without leaving your AI workflow.

Available Tools

create_quiz

Create a new quiz with questions. Returns an admin URL (containing the encryption key and admin token) plus a join URL for participants.

title(required) — The quiz title
description(optional) — Quiz description
questions(required) — Array of questions with text, options, correctIndex, and optional timerOverride
timerSeconds(optional, default: 20) — Default timer per question in seconds (0 = no timer)
expirationHours(optional, default: 24) — Hours until the quiz expires (1–168)

get_quiz

Get the full details of a quiz including all decrypted questions, participants, and state. Requires the admin URL.

adminUrl(required) — The admin URL returned when the quiz was created

add_question

Add a new question to an existing quiz (must be in lobby state). Requires the admin URL.

adminUrl(required) — The admin URL returned when the quiz was created
text(required) — The question text
options(required) — 2–4 answer options
correctIndex(required) — 0-based index of the correct answer
timerOverride(optional) — Per-question timer override in seconds (5–120)

update_question

Update an existing question in a quiz (must be in lobby state). Requires the admin URL.

adminUrl(required) — The admin URL returned when the quiz was created
index(required) — 0-based index of the question
text(required) — The question text
options(required) — 2–4 answer options
correctIndex(required) — 0-based index of the correct answer
timerOverride(optional) — Per-question timer override in seconds (5–120)

remove_question

Remove a question from a quiz (must be in lobby state). Remaining questions are re-indexed. Requires the admin URL.

adminUrl(required) — The admin URL returned when the quiz was created
index(required) — 0-based index of the question

delete_quiz

Permanently delete a quiz and all its data. This cannot be undone. Requires the admin URL.

adminUrl(required) — The admin URL returned when the quiz was created

About the Admin URL

When you create a quiz via MCP, the AI assistant receives the admin URL which contains both the encryption key and admin token. This URL is not stored on the server — it only exists in the AI's conversation memory. Depending on which AI tool you use, be aware that the admin URL may persist in your conversation history. Only create quizzes through trusted AI tools and treat the admin URL like a password.

Setup Instructions

Claude Desktop

Add the following to your Claude Desktop configuration file. On macOS this is at ~/Library/Application Support/Claude/claude_desktop_config.json

// claude_desktop_config.json
{
  "mcpServers": {
    "quiz": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://quiz.switch-to.eu/api/mcp/mcp"
      ]
    }
  }
}

Requires mcp-remote (installed automatically via npx) to bridge stdio to HTTP.

Cursor / Windsurf

Add a .cursor/mcp.json or .windsurf/mcp.json file to your project root. These editors support streamable HTTP natively.

// .cursor/mcp.json or .windsurf/mcp.json
{
  "mcpServers": {
    "quiz": {
      "url": "https://quiz.switch-to.eu/api/mcp/mcp"
    }
  }
}

Claude Code

Add a .mcp.json file to your project root or home directory.

// .mcp.json
{
  "mcpServers": {
    "quiz": {
      "type": "url",
      "url": "https://quiz.switch-to.eu/api/mcp/mcp"
    }
  }
}

Security Note

All quiz content is encrypted with AES-256-GCM before storage — the server never sees the plaintext. When creating or managing quizzes via MCP, the encryption key and admin token travel through the MCP protocol. Only use this with trusted AI tools and share quiz join links (not admin links) with participants.