PlayQuizNow MCP Server

An MCP (Model Context Protocol) server for PlayQuizNow — the online quiz platform for education, training, and live events.

This server lets AI assistants like Claude Desktop, Claude Code, and other MCP-compatible tools create and manage quizzes directly on PlayQuizNow.

What can it do?

Example prompts

Once connected, just ask your AI assistant:

• "Create a 10-question quiz about the French Revolution with multiple choice answers"
• "Make a private timed quiz on Python basics — 20 seconds per question, with explanations"
• "Create a quiz about climate change with negative marking for wrong answers"
• "List my quizzes"
• "Show me the details of quiz ABC123"

Quick Start

1. Get an API Key

Log into PlayQuizNow, go to API Keys (in your profile menu), and create a new key. You'll get a key like pqn_a1b2c3d4... — save it, it's shown only once.

2. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "playquiznow": {
      "command": "uvx",
      "args": ["playquiznow-mcp"],
      "env": {
        "PLAYQUIZNOW_API_KEY": "pqn_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You're ready to create quizzes.

3. Try it

Ask Claude: "Create a quiz about space exploration with 5 questions"

Claude will generate the questions and create the quiz on PlayQuizNow. You'll get a join code and link that players can use immediately.

Quiz Creation Options

The create_quiz tool supports all quiz configuration options:

Quiz Settings

Question Settings

Limits

• Max 100 questions per quiz
• Max 10 question sets per quiz
• Max 8 answer options per question
• MCQ questions must have at least 1 correct answer

Environment Variables

Development

git clone https://github.com/playquiznow/playquiznow-mcp.git
cd playquiznow-mcp
pip install -e .

# Run locally against a dev server
PLAYQUIZNOW_API_KEY=pqn_... PLAYQUIZNOW_BASE_URL=http://localhost:8000 playquiznow-mcp

About PlayQuizNow

PlayQuizNow is an online quiz platform for educators, trainers, and event organizers. Features include:

• Single-player and live multiplayer quizzes
• LTI integration (Canvas, Moodle, Blackboard, D2L)
• WordPress plugin and embeddable widget
• Google Classroom integration
• Enterprise SSO
• Real-time leaderboards and analytics

License

MIT