rooquiz/rooquiz-mcp

Remote MCP server for RooQuiz — a lightweight assessment platform for lead capture and viral sharing. Build quizzes with AI-assisted authoring, capture leads from results pages, and analyze funnel conversion — straight from Claude, ChatGPT, Cursor, or any MCP client.
- **Endpoint:** https://payload.rooquiz.com/api/mcp (Streamable HTTP)
- **Auth:** OAuth 2.1 — authorization code + PKCE with dynamic client registration. Sign in with your RooQuiz account when your client prompts you; no API key needed.
- **Registry name:** com.rooquiz/rooquiz-mcp
Connect
One-click: VS Code · VS Code Insiders · Cursor
**Claude Code**
**claude.ai / ChatGPT** — add a custom connector and paste the endpoint URL.
**Cursor** (.cursor/mcp.json)
**VS Code / GitHub Copilot** (.vscode/mcp.json)
Example prompts
Once connected, talk to it in plain language. Each of these exercises a different
part of the server:
**Build from a template**
> Show me the coaching templates, create a scored quiz from the readiness one, then add
> two questions about budget.
*Exercises list_templates → create_form_from_template → add_question.*
**Work the leads**
> List the leads my Wheel of Life quiz captured this week, tag everyone who scored under
> 40 as follow-up, and assign them to me.
*Exercises list_leads → set_lead_tags → assign_leads.*
**Diagnose the funnel**
> Which of my quizzes has the worst completion rate, and where exactly do people drop off?
*Exercises list_forms → get_form_stats → get_form_funnel.*
**Go multilingual**
> Translate my promotion-readiness quiz into Spanish and German, keeping the question codes.
*Exercises list_form_translations → create_form_translation.*
Respondent names, email addresses and phone numbers come back masked (j***g@example.com),
so address a respondent by id rather than pasting a masked value back in.
What you can do
- **Quizzes** — create knowledge quizzes, scored quizzes, and "which X are you" outcome quizzes; edit questions, scoring formulas, and dimension analysis; start from templates
- **Translations** — one source form, mirrored translations in any language
- **Leads** — list, tag, assign, and comment on leads captured from quiz results pages
- **Respondents & records** — look up respondents, submissions, stats, and funnel analytics
- **Bookings** — review and reschedule bookings made through quiz results pages
- **Team** — switch active team, invite members, manage question banks and categories
All tools act within the team your session is bound to.
stdio bridge
Hosts without native HTTP transport (Claude Desktop, older MCP clients) and registry
crawlers that build a container can go through the bridge in bin/rooquiz-mcp.mjs
— dependency-free, Node 18+. Everything above is a better path if your client speaks HTTP.
| Env | Default | Purpose |
| --- | --- | --- |
| ROOQUIZ_TOKEN | *(unset)* | Bearer token — **required for every hosted tool** |
Every method needs a token, initialize included: without one the server answers 401 with
a WWW-Authenticate header pointing at the resource metadata. Clients with native HTTP
transport get this for free through OAuth; the bridge has nowhere to run a browser flow, so