Parliamo del progetto

AI · MCP

The Quiz Master

Quiz da pub condotti in sala e scritti anche dall'AI

Il nostro ruolo
Own product: design and full-stack development
Periodo
2026
Stato
Beta
Schermate
MCP, Website, Host app, Player

Apri thequizmaster.app

The Quiz Master: MCP in uso: un assistente AI costruisce un quiz in 3 round sul calcio anni '90 con gli strumenti di Quiz Master, e il quiz arriva in libreria pronto da condurre (mockup illustrativo).

Quiz Master è una web app per condurre serate quiz: si costruisce la scaletta, la si prova e poi la si proietta a schermo intero, assegnando i punti alle squadre da un pannello di controllo. Il suo server MCP permette ad assistenti AI come Claude o ChatGPT di scrivere i quiz direttamente nella libreria dell'host. Basta chiedere "un quiz da pub in 3 round sul calcio anni '90" e il quiz completo compare in Quiz Master, pronto da condurre.

Chi lo usa e per cosa

  • Un presentatore di quiz chiede a Claude una serata a tema e riceve un quiz completo con round, soluzioni e classifica.
  • Un presentatore costruisce in chat un round di immagini o di musica, e l'assistente trova i file e li importa nello storage dell'app.
  • Un presentatore riusa le domande del proprio archivio in più serate, e ogni modifica compare in tutti i quiz che usano quella domanda.
  • Durante la serata il presentatore guida il quiz dal portatile, mentre la sala guarda lo schermo con il tema scelto.

Come è fatto

  • Server MCP remoto con 17 strumenti tipizzati e validati con zod per quiz, segmenti della scaletta, archivio domande e import dei media.
  • L'accesso è un flusso OAuth 2.1 completo, con registrazione dinamica del client e PKCE: per collegarsi basta l'URL del server, senza chiavi API.
  • Il server non ha strumenti di cancellazione, e ogni richiesta tocca solo i dati dell'host autenticato.
  • 10 temi animati con GSAP per lo schermo del pubblico. Presenter e pannello di controllo girano in due finestre e funzionano anche offline.

Tecnologie

  • Vue 3 + TypeScript
  • Pinia
  • Vite
  • Tailwind CSS v4
  • GSAP
  • Firebase (Auth, Firestore, Storage, Functions, Hosting)
  • Model Context Protocol SDK
  • Express + zod
  • OAuth 2.1 (PKCE, dynamic client registration)

In numeri

  • Remote MCP server with 17 typed tools at thequizmaster.app/mcp
  • Own OAuth 2.1 authorization server with dynamic client registration, required S256 PKCE and hashed opaque tokens
  • Authoring only: no delete tools, and every read or write is scoped to the signed-in host
  • 10 presenter themes, 9 question types, 14 timeline segment types
  • Media import copies images, audio and video into the app's own storage (25 MB cap, SVG rejected)
  • About 118 Vue single-file components. Presenter and control panel stay in sync across two windows via BroadcastChannel
  • Keeps working offline mid-quiz thanks to Firestore's persistent multi-tab cache

Strumenti che l’AI può usare

StrumentoCosa fa
get_authoring_guideReturns the authoring spec: localized text, segment structure, question and answer shapes, quality guidance. The assistant reads it first.
list_themesLists the presenter themes a quiz can use (Arcade, Cosmos, Quiz Board, Terminus, Chalkboard, ...).
list_quizzesLists the host's quiz templates with languages, theme and per-round question counts.
get_quizFetches one quiz in full, with the round questions included inline.
create_quizCreates a quiz template; can import a complete running order in one call.
update_quizPatches title, description, theme, languages, settings and metadata.
add_segmentInserts a timeline segment (welcome, rules, round, answer reveal, break, scoreboard, ...). A new round gets a matching answer-reveal segment automatically.
update_segmentPatches one segment's fields.
remove_segmentRemoves a segment and renumbers the timeline. The questions stay in the question bank.
move_segmentMoves a segment to a new position in the running order.
search_questionsSearches the host's question bank by text, tags, type and difficulty.
get_questionFetches one question in full (prompt, answer, media, clue stages, sub-questions, tags).
create_questionCreates a standalone question in the question bank, with an optional image, audio clip or YouTube video.
update_questionEdits a question. The change shows up in every quiz that uses it.
add_questions_to_roundAdds new inline questions or existing questions from the bank to a round.
remove_question_from_roundUnlinks a question from a round without deleting it.
import_mediaCopies a remote image, audio or video file into Quiz Master storage and returns a permanent URL.

MCP

The Quiz Master, MCP: MCP in uso: un assistente AI costruisce un quiz in 3 round sul calcio anni '90 con gli strumenti di Quiz Master, e il quiz arriva in libreria pronto da condurre (mockup illustrativo).
MCP in uso: un assistente AI costruisce un quiz in 3 round sul calcio anni '90 con gli strumenti di Quiz Master, e il quiz arriva in libreria pronto da condurre (mockup illustrativo).
The Quiz Master, MCP: I 17 strumenti esposti dal server MCP: quiz, segmenti della scaletta, archivio domande e import dei media. Niente di distruttivo.
I 17 strumenti esposti dal server MCP: quiz, segmenti della scaletta, archivio domande e import dei media. Niente di distruttivo.

Website

The Quiz Master, Website: La pagina di collegamento: un URL del server e l'accesso OAuth, poi l'assistente lavora nella tua libreria di quiz.
La pagina di collegamento: un URL del server e l'accesso OAuth, poi l'assistente lavora nella tua libreria di quiz.
The Quiz Master, Website: La landing page su thequizmaster.app.
La landing page su thequizmaster.app.

Host app

The Quiz Master, Host app: Editor del quiz: scaletta a sinistra, anteprima della slide al centro, ispettore della domanda a destra.
Editor del quiz: scaletta a sinistra, anteprima della slide al centro, ispettore della domanda a destra.

Player

The Quiz Master, Player: Ciò che vede la sala: una domanda con immagine nel tema Arcade, accanto ai controlli del presentatore.
Ciò che vede la sala: una domanda con immagine nel tema Arcade, accanto ai controlli del presentatore.

Tutte le schermate mostrano dati dimostrativi inventati.

Preferisci scrivere liberamente?

Raccontaci cosa vuoi realizzare.

Accettiamo nuovi lavori: MVP, rifacimenti, integrazioni AI, oppure un ingegnere senior nel tuo team per un periodo. Bastano poche righe sull’idea per iniziare.

Scrivici