Skip to main content
Glama

Quiz

quiz

Render an interactive quiz. The card only renders; YOU (the model) define everything. Inputs: title (optional), description (optional), perPage (how many questions to show per page, default 1), and questions — an array of { prompt, type ("single" | "multiple", default "single"), options, explanation? }. Each option is { label, score } (or a bare string, with an optional parallel scores array). Set score per option (can be negative) to weight answers. The card paginates, lets the user answer single/multiple choice, computes the total, and sends the selections and score back through the conversation so you can respond. Use whenever a user wants a test, quiz or questionnaire.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
titleNoQuiz title.
localeNoUI language for the rendered card.en
perPageNoHow many questions to show per page (1–10).
questionsYesArray of questions. Each: { prompt, type: "single" | "multiple", options: [{ label, score }], explanation? }.
descriptionNoShort instructions shown under the title.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden, and it does so well: it discloses that the card paginates, lets the user answer single/multiple choice, computes a total, and sends selections and score back through the conversation. That round-trip behavior is non-obvious and important. It omits any auth/permission or rendering-failure behavior, keeping it just below a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is front-loaded with the core purpose and the model/card division of responsibility, then walks through inputs and behavior in ordered sentences. It is dense rather than bloated, though the 'Inputs:' enumeration partially restates schema fields and could be tightened.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description must explain the return path, and it does ('sends the selections and score back through the conversation so you can respond'). Nested question/option structure is also covered. The unexplained locale parameter and absent pagination edge cases keep it from a perfect score.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds genuine meaning beyond the schema: it documents the perPage default of 1, the question object shape, the option { label, score } form, the bare-string alternative with a 'parallel scores array', and that scores can be negative. Only the locale parameter's role is left to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific verb and resource ('Render an interactive quiz') and immediately clarifies the division of labor: 'The card only renders; YOU (the model) define everything.' An agent knows exactly what this tool produces and how it differs from sibling visualization utilities like typing-test or random-picker.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The closing sentence gives clear trigger conditions ('Use whenever a user wants a test, quiz or questionnaire'), which is strong positive guidance. However, it offers no exclusions or routing against the closest siblings (typing-test, reaction-test, random-picker), so it falls short of the explicit when-not guidance needed for a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources