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?
| Tool | Description |
|---|---|
create_quiz |
Create a quiz with questions, answers, timing, scoring, and access controls |
list_my_quizzes |
List all quizzes you've created |
get_quiz |
Get full quiz details by join code |
delete_quiz |
Delete a quiz by ID |
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
| Parameter | Type | Default | Description |
|---|---|---|---|
title |
string | required | Quiz title |
description |
string | "" |
Description shown to players |
quiz_mode |
enum | "single_player" |
single_player or multi_player |
access_type |
enum | "public" |
public, private, or unlisted |
negative_marking |
boolean | false |
Deduct points for wrong answers |
auto_start_quiz |
boolean | false |
Skip waiting room |
start_datetime |
ISO 8601 | now | When quiz becomes available |
end_datetime |
ISO 8601 | — | When quiz closes |
max_plays_per_participant |
integer | — | Limit plays per player |
marketing_text |
string | — | Text shown on results page |
marketing_link |
string | — | URL linked from results page |
Question Settings
| Parameter | Type | Default | Description |
|---|---|---|---|
text |
string | required | Question text (plain text) |
question_type |
enum | "mcq_text" |
mcq_text, poll, or text_answer |
answers |
array | required | Answer options (1-8 per question) |
positive_points |
number | 1 |
Points for correct answer |
negative_points |
number | 0 |
Points deducted for wrong answer |
time_for_question |
integer | 30 |
Seconds to answer (5-300) |
time_for_answer |
integer | 10 |
Seconds to show explanation (3-60) |
correct_answer_explanation |
string | "" |
Explanation shown after answering |
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
| Variable | Required | Default | Description |
|---|---|---|---|
PLAYQUIZNOW_API_KEY |
Yes | — | Your PlayQuizNow API key (pqn_...) |
PLAYQUIZNOW_BASE_URL |
No | https://api.playquiznow.com |
API base URL |
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
Metadata
Release files for playquiznow-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| playquiznow_mcp-0.1.0.tar.gz | 13.5 kB | Without provenance | Details for playquiznow_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| playquiznow_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for playquiznow_mcp-0.1.0-py3-none-any.whl |
Total release size: 25.6 kB
Release files / playquiznow_mcp-0.1.0.tar.gz
| Download URL | playquiznow_mcp-0.1.0.tar.gz |
|---|---|
| Size | 13.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
50d3a095ef9a796754ee0ec4f44e1f72117e1e6257258afa87ba46efd362d16d
|
|
BLAKE2b-256 checksum How to use checksums |
580cfd15d133fd0327855099a20b38f39d73a2817111ea5ad699e4b9d800132d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.9
|
Release files / playquiznow_mcp-0.1.0-py3-none-any.whl
| Download URL | playquiznow_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 12.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c3f3d6674a19cf5403e2c4bfbf4df74c9a00e57347ff8a9352f532ef519026da
|
|
BLAKE2b-256 checksum How to use checksums |
87780a5bfb85732aaf051f9cf13d65b8239799b713a2940bd81554bbb18b1e5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.9
|
Security for playquiznow-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.