riddle.com

Stores an existing Riddle as a template of its project (or of the user, for a personal Riddle), so new Riddles can be created from it with riddleTemplate_use.

Lists the templates of a project (or your personal ones) - the ones made from your own Riddles with riddleTemplate_create, NOT Riddle's public ones, which riddleTemplate_publicList returns.

Lists Riddle's public templates - the ready-made ones available to every account, as opposed to riddleTemplate_list, which returns the ones your project made itself.

Reads a single template, by default INCLUDING its build configuration - the same "build" shape riddle_get returns and the riddle_builder_<type> tools accept.

Creates a new Riddle from a template, as an unchanged copy of it - content, settings and design preset - and records it as a copy of the template's Riddle (riddle_get reports that as context.

Lists the tags of a project together with how many Riddles use each of them: [{id, name, count}].

Adds a tag to one or many Riddles.

Removes a tag from one or many Riddles.

A simple tool that returns "Pong".

Returns a paginated list of Riddles from a single project.

Returns a paginated list of all Riddles across the entire account — both the personal project and all team projects the user has access to.

Gets one Riddle - or several, with UUIDs - as a compact build-configuration envelope: {uuid, type, modifiedAt, build, nextBlockId, warnings, published, context}.

Gets the HTML embed code for a Riddle by its UUID.

Publishes one or many Riddles; meaning each Riddle will be available via https://www.

Unpublishes one or many Riddles; meaning each Riddle will no longer be available via https://www.

Renames a Riddle with the specified UUID.

Generates a QR code for a Riddle by its UUID.

Deletes one or many Riddles.

Moves one or many Riddles into another project, or into the personal project when projectId is omitted.

Checks, without changing anything, whether a set of Riddles can be moved and which projects they can be moved to - the same check riddle_move runs before it moves anything.

Returns information about the current API key: the authenticated user (email, name - "userEmail"/"userName", "userName" is null if the user never set one) and the associated project/team if using a project API key.

Creates a new, empty question bank for the given Riddle type ("Quiz" or "Poll").

Lists the question banks of a project - the same banks the Creator's question bank list shows; pass a projectId to look into another project, omitting it lists the banks of the project the API key is scoped to (the personal ones for a user API key).

Lists the built-in template question banks - pre-filled starter banks anyone can duplicate with questionBank_duplicate to get a bank with real content immediately, instead of starting empty.

Retrieves a single question bank by id: its title, riddleType, tags, notes, its categories/blockTypes and whether it has unpublished changes.

Renames a question bank, immediately and permanently - the title is metadata, not a bank's DRAFT content, so this is unaffected by questionBank_publish/discardChanges and never shows up as an unpublished change.

Sets the plain-text notes of a question bank, replacing whatever was there before, immediately and permanently - like the title, notes are metadata outside the DRAFT/publish split, so this is unaffected by questionBank_publish/discardChanges and never shows up as an unpublished change.

Duplicates a question bank and every one of its items into a new, independent bank - the items are copies, editing one bank never affects the other.

Publishes a question bank: every item's draft content becomes its published content, which is what a QuestionBank block actually draws from at view time - exactly like publishing a Riddle makes its draft live.

Discards every unpublished change of a question bank, resetting all of its items back to their last published state.

Deletes a question bank and every one of its items.

Adds one question/item to a question bank.

Replaces the content of an existing question bank item entirely - blockType, category, difficulty and columns all have to be sent, even the ones that are not changing.

Deletes one item from a question bank; does not affect the rest of the bank.

Lists the items (draft content) of a question bank, optionally filtered by search term, blockType, category or difficultyRange - the same filters the Creator's question bank grid offers.

Lists every question bank tag of a project together with how many banks use each - the tag "id" values questionBank_list's "tags" filter accepts.

Adds a tag to a question bank, identified either by tagName (reusing the project's tag of that name, or creating it if there is none yet) or by tagId from questionBank_tagList.

Removes a tag from a question bank by tagId.

Lists every blockType valid for a question bank of the given Riddle type, with the exact "columns" shape questionBank_addItem/updateItem expects for that blockType.

Counts, per criterion of a QuestionBank block, how many published items in the bank currently match it - this is a count preview, NOT a preview of the items a real draw would pick.

Reads the palettes - colors, fonts, button styles and background settings - of a Riddle.

Changes the palette (colors, fonts, button styles, background) of a single Riddle.

Builds a Quiz from a build configuration.

Builds a Poll from a build configuration.

Builds a Personality Test from a build configuration.

Builds a Form from a build configuration.

Builds a Predictor from a build configuration.

Builds a Leaderboard from a build configuration.

Builds a Minigame from a build configuration.

Builds a Story from a build configuration: the simplest block-based Riddle type - a sequence of content blocks (optionally with form blocks to collect lead data) plus an optional result page, with no questions, scoring or leaderboard.

Builds a Placeholder from a build configuration: a Riddle with no content of its own, only a routing rule that is resolved when the Placeholder is displayed, to decide which OTHER Riddle (or a Riddle picked by tag) to actually show.

Edits an existing Riddle of any type with the same build configuration the riddle_builder_<type> tools take - but as a merge, not a rebuild: only what you send is changed.

Dry-runs one or many Riddle Builder creates and/or edits without creating or changing anything: per entry of $builds, the same validation the real call would apply, against a scratch/deep-copied Riddle that is discarded before this returns - never persisted, never published, no event dispatched.

Read the documentation of this MCP server: the block types, form field types, result blocks, palette values and response shapes the other tools expect.

Returns aggregated statistics (views, starts, submissions) for a single period.

Returns statistics divided into daily intervals for the given date range.

Returns a detailed stats breakdown for a specific Riddle, including titles, choices, views, time spent, and submissions.

Returns a stats breakdown for the authenticated user across all accessible projects.

Returns a stats breakdown for a specific project.

Returns a paginated list of projects this token has access to (25 per page by default, 100 max), with a sibling "pagination" object ({page, pageSize, total, hasMore}) to page through accounts with many projects.

Returns a single project by its project ID: id, name, image and the permission matrix of the authenticated user for it.

Returns the project's default Riddle settings that every new Riddle in it starts from - PUBLISHED and ENABLED only: "publishSettings" (privacy/DOI/OTP, email automation, tracking, data layer, .