For agents & the people driving them
Point your AI at QuizGen.
QuizGen is a remote MCP server. Connect it once, authorize your account in the browser, and your assistant can create hosted quizzes, read responses, and run follow-up workflows in every conversation.
01
Connect the MCP server
Use the same remote endpoint in ChatGPT, Claude, Codex, Cursor, VS Code, or any client that supports streamable HTTP MCP. Opening the setup page does not connect a plain chat by itself—the client must add the MCP server.
$ https://quizgen.dev/mcpCodex
codex mcp add quizgen --url https://quizgen.dev/mcp --oauth-resource https://quizgen.dev/mcp codex mcp login quizgen
Claude Code
claude mcp add --transport http --scope user quizgen https://quizgen.dev/mcp # Then open /mcp in Claude Code and authorize QuizGen.
02
Use outcome-first prompts
You do not need to name tools or describe the JSON schema. Ask for the whole result and let the connected agent choose the tools.
Create and publish a five-question client intake form asking for name, budget, timeline, goals, and what they have already tried. Give me the live link. Find my client intake quiz, summarize completed responses, show the budget breakdown, and rank the strongest leads with your reasoning. Email my onboarding quiz to alex@example.com. Before sending, show me the recipient and message for confirmation; after I confirm, schedule one reminder in three days for non-completers.
03
Optional: add the QuizGen skill
MCP gives your assistant access to QuizGen. The optional skill teaches it stronger quiz design, recovery behavior, and the full API schema. It complements MCP; it does not replace the connection.
$ npx skills add Tariqlearnstocode/quizgen-skillsCodex, Claude Code, Cursor, or another terminal agent: run the command above.
04
Raw HTTP fallback for executable agents
Use this only when the agent can actually execute HTTPS requests. No Authorization header creates a 72-hour sandbox with a private claim link. API keys belong in secret configuration—not prompts.
curl -X POST https://quizgen.dev/api/v1/quizzes \
-H "Content-Type: application/json" \
--data '{ "schema_version": 1, "title": "Coffee or tea?",
"sections": [ { "key": "main", "questions": [
{ "id": "pick", "type": "choice", "prompt": "Coffee or tea?",
"options": [ { "value": "coffee", "label": "Coffee" },
{ "value": "tea", "label": "Tea" } ] } ] } ] }'
# → { "url": "https://quizgen.dev/q/x7km2p", "sandbox": true, ... }05