MCP Integration

Create and manage quizzes directly from any MCP-compatible AI assistant or tool.

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 participant URL.

title(required) — The quiz title

description(optional) — Quiz description

questions(required) — Array of questions with text, options, correctIndex, and optional timerOverride

timerSeconds(optional, default: 0) — Default timer per question in seconds (0 = no timer)

expirationHours(optional, default: 0) — Hours until the quiz expires (0 = no expiration, 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 draft 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 draft 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 draft 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 tool you use, be aware that the admin URL may persist in your conversation history. Only create quizzes through trusted tools and treat the admin URL like a password.

Setup Instructions

Streamable HTTP (recommended)

If your MCP client supports streamable HTTP, add the server URL directly to your MCP configuration file.

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

Stdio Bridge

For MCP clients that only support stdio transport, use the mcp-remote bridge to connect over HTTP.

{
  "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.

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 tools and share quiz join links (not admin links) with participants.