{"id":"com.riddle/creator","slug":"com-riddle-creator","title":"Riddle","description":"Build, publish and analyze quizzes, polls, forms and personality tests. Riddle account required.","version":"1.0.2","publisher":{"kind":"domain","id":"riddle.com","label":"riddle.com","url":"https://riddle.com"},"website":"https://www.riddle.com/help/api/mcp","repository":"","remotes":[{"type":"streamable-http","url":"https://www.riddle.com/creator/api/v3/mcp"}],"packages":[],"published":"2026-08-20","updated":"2026-08-20","status":"online","auth":"","latency_ms":1288,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"media_upload_link","title":"Create media upload link","description":"Creates a single-use link for uploading ONE media file into the media library. Call it when the user has a LOCAL file for a Riddle: this server cannot receive bytes, so the upload is yours. A link expires after 5 minutes, dies on first use (successful or not), and only 20 are handed out per account per 5 minutes - so create one immediately before each upload, a batch one file at a time rather than","read_only":false},{"name":"media_delete","title":"Delete media library file","description":"Deletes a file from the media library permanently, to clean up after yourself: an upload that turned out wrong, or a file the user no longer wants stored (it frees the storage it counted against). The file must be unused - one any Riddle still shows is refused with a message naming those Riddles, since deleting it would leave a broken image behind in a live Riddle; remove it there first (riddle_bu","read_only":false},{"name":"riddle_template_create","title":"Create riddle template","description":"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 riddle_template_use. The template is a copy taken at this moment - the Riddle keeps living its own life and later changes to it do not reach the template. It copies what the Riddle currently has stored, published or not. Returns the created template: {id, title","read_only":false},{"name":"riddle_template_update","title":"Update riddle template","description":"Changes a template's title and/or its gallery image and icon. Images: media_upload_link into the template's project, pass the reported \"mediaId\" (stored by URL - deleting the file breaks the image). Only what you pass changes; the template's content cannot be changed (create a new template from the edited Riddle). Public templates only by Riddle admins. Returns the template like riddle_template_cr","read_only":false},{"name":"riddle_template_list","title":"List riddle templates","description":"Lists the templates of a project (or your personal ones) - the ones made from your own Riddles with riddle_template_create, NOT Riddle's public ones, which riddle_template_public_list returns. Quick-create templates (isQuickCreate: true) are included alongside the regular ones; there is no separate listing for them. \"type\" filters by Riddle type. Returns {items: [{id, title, type, blocksCount, ima","read_only":true},{"name":"riddle_template_public_list","title":"List public riddle templates","description":"Lists Riddle's public templates - the ready-made ones every account has, as opposed to riddle_template_list's own ones. They are grouped by category (the tag the Creator sorts them by), so calling this without arguments is also how you learn which categories exist; \"category\" and \"type\" narrow it. Returns {categories: {<category>: [{id, title, type, blocksCount, image, icon, createdAt, riddle, isP","read_only":true},{"name":"riddle_template_get","title":"Get riddle template","description":"Reads one template, by default INCLUDING its build configuration - the same \"build\" shape riddle_get returns and riddle_builder_create accepts. This is how a template is ADAPTED rather than copied: edit the returned \"build\" (wording, questions, blocks) and build it with riddle_builder_create under the template's \"type\", passing this id as \"templateId\" so the new Riddle is still recorded as coming ","read_only":true},{"name":"riddle_template_use","title":"Create riddle from template","description":"Creates a new Riddle from a template as an unchanged copy of it - content, settings and design preset - recorded as a copy of the template's Riddle (riddle_get reports it as context.duplicated). Use this whenever the template is what you want; to adapt it first, read it with riddle_template_get and build the edited configuration with riddle_builder_create instead. The new Riddle is a DRAFT - riddl","read_only":false},{"name":"riddle_tag_list","title":"List riddle tags","description":"Lists the tags of a project as {items: [{id, name, count, bankCount}]}, unpaginated - the labels the Creator shows and riddle_list's \"tags\" filter selects by, and where the ids that filter takes come from. Riddle tags and question bank tags are ONE set per project (question_bank_tag_add/_remove are the bank side of the same tags, with the same ids), and a tag belongs to a project: \"Campaign 2026\" ","read_only":true},{"name":"riddle_tag_add","title":"Add tag to riddles","description":"Puts a tag on Riddles - ONE assignment per Riddle, never the tag itself (riddle_tag_list reads the labels of a project, riddle_tag_remove takes a tag off again, riddle_tag_delete removes a label). Gives one Riddle (UUID) or many (UUIDs, max 100) the tag named by tagName - created in each Riddle's OWN project if it has none of that name, so one call can span projects - or by tagId, which exists in ","read_only":false},{"name":"riddle_tag_remove","title":"Remove tag from riddles","description":"Takes a tag off Riddles - ONE assignment per Riddle (riddle_tag_add puts it on, riddle_tag_delete removes a label nothing carries). Untags one Riddle (UUID) or many (UUIDs, max 100), by tagName or tagId, and creates nothing: a tag the Riddle or its project does not have is an error for that Riddle. Untagging the LAST carrier deletes the tag itself from the project, unless a question bank still use","read_only":false},{"name":"riddle_tag_delete","title":"Delete riddle tag","description":"Deletes the TAG ITSELF from a project - the label, for good - and no Riddle, no question bank and no assignment. Rarely needed: untagging the last carrier already removes a tag (riddle_tag_remove), so this is for a leftover from before that cleanup existed. It detaches nothing on the way, so a tag any Riddle or question bank still carries is rejected with a message naming how many of each - check ","read_only":false},{"name":"ping","title":"Ping the MCP server","description":"A simple tool that returns \"Pong\". Can be used to test connectivity and authentication to the MCP.","read_only":true},{"name":"riddle_list","title":"List riddles","description":"Returns a paginated list of Riddles. With the default scope \"project\" they come from a single project - use projectId to name it, or omit it for the project the API key is scoped to. With scope \"account\" they come from the entire account instead: the personal project and every team project the user has access to, in one list - the account-wide listing is this scope, not a tool of its own; projectI","read_only":true},{"name":"riddle_get","title":"Get riddle","description":"Reads one Riddle - or several, with UUIDs - as the compact build-configuration envelope {uuid, type, modifiedAt, build, nextBlockId, warnings, published, context}. \"build\" is the DRAFT and is exactly what the riddle_builder_* tools accept back; \"published\" is the live version visitors see (null = never published, {\"status\": \"identical\"} = the live version matches the draft, {\"status\": \"differs\", \"","read_only":true},{"name":"riddle_get_embed_code","title":"Get riddle embed code","description":"Gets the HTML embed code for a Riddle by its UUID. The code is returned regardless of publish state, but the URL it embeds will not serve the Riddle until it is published.","read_only":true},{"name":"riddle_publish","title":"Publish or unpublish riddle","description":"Publishes one or many Riddles, or takes them off the web again with publish: false (there is no unpublish tool). A published Riddle's public URL is the response's \"context.viewUrl\" - report that, never one spelled from the UUID (hosts differ per environment). With UUID the response is the riddle_get envelope with the new state under \"context.published\" (\"omit\" shrinks it the same way); with UUIDs ","read_only":false},{"name":"riddle_rename","title":"Rename riddle","description":"Renames a Riddle with the specified UUID. Returns only the confirmation of the change (uuid, title, modified state), not the entire Riddle. Only if the Riddle's origin.writableByThisKey is true (riddle_get, riddle_list): riddle://reference/concepts/access.","read_only":false},{"name":"riddle_delete","title":"Delete riddle","description":"Deletes one or many Riddles. Pass UUID for one, or UUIDs (max 100) to clean up several at once - e.g. everything riddle_list returned with origin: \"api\". A bulk delete is not atomic and never gives up early: a Riddle that cannot be deleted is that entry's \"error\" and every other Riddle is still deleted (riddle://reference/concepts/bulk). A Riddle another item of the same batch still references (a ","read_only":false},{"name":"riddle_move","title":"Move riddle to another project","description":"Moves one or many Riddles into another project or into the personal project - and, given no destination, reports whether it could instead of moving anything. Pass UUID for one Riddle or UUIDs (max 100) for several. CHECK MODE: leave projectId out (or pass dryRun: true alongside one) and NOTHING is changed - the call runs the very same validation a real move runs and answers {canMoveAll, movable, b","read_only":false},{"name":"whoami","title":"Show the connected account","description":"Reports the current API key: the authenticated user (\"userEmail\"/\"userName\", the latter null if never set), the project/team on a project-scoped key, whether this key has full access (\"allowsFullAccess\", see riddle://reference/concepts/access), and the account's plan in \"subscription\" ({plan, period, active, created, termEnd, isFreeTrial, daysLeft} - on a free trial \"termEnd\" is when the trial end","read_only":true},{"name":"question_bank_create","title":"Create question bank","description":"Creates a new, empty question bank for the given Riddle type (\"Quiz\" or \"Poll\"). Add items with question_bank_item_add, then reference the returned \"id\" as \"questionBankId\" on a QuestionBank block of a riddle_builder_create call of the matching \"type\" - a bank created for \"Quiz\" can only be referenced from a Quiz, never a Poll, and vice versa. A bank lives in one project and can only be referenced","read_only":false},{"name":"question_bank_list","title":"List question banks","description":"Lists question banks. Scope \"own\" (the default) lists the banks of a project - the same ones the Creator shows; pass a projectId to look into another project, omit it for the project the API key is scoped to (your personal ones on a user API key). Paginated {items, page, pageSize, total, hasMore}. Scope \"templates\" lists the built-in starter banks instead - pre-filled banks anyone can copy with qu","read_only":true},{"name":"question_bank_get","title":"Get question bank","description":"Retrieves one question bank by id: title, riddleType, tags, notes, its categories/blockTypes and whether it has unpublished changes. The items themselves are question_bank_get_items, not included here. Works on a built-in template id from question_bank_list(scope: \"templates\") to see what it holds before duplicating - a template reads back without owner and tags/notes, belonging to nobody. \"catego","read_only":true},{"name":"question_bank_rename","title":"Rename question bank","description":"Sets the title of a question bank. The title is metadata rather than DRAFT content, so it takes effect immediately AND permanently, is unaffected by publishing or discarding and never counts as an unpublished change. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.","read_only":false},{"name":"question_bank_update_notes","title":"Update question bank notes","description":"Replaces the plain-text maintainer notes of a question bank (never shown to participants) - the previous notes are overwritten entirely, not appended to, so read them with question_bank_get first and send everything that should remain. Notes are metadata rather than DRAFT content: the change takes effect immediately AND permanently, is unaffected by publishing or discarding and never counts as an ","read_only":false},{"name":"question_bank_duplicate","title":"Duplicate question bank","description":"Copies a question bank and all of its items into a new, independent bank (editing one never affects the other) in projectId or the key's project. The source is left untouched. This is the one write a public template id is accepted for, and the way to change a template: duplicate it and edit the copy. Needs full access: riddle://reference/concepts/access.","read_only":false},{"name":"question_bank_publish","title":"Publish question bank","description":"Makes every item's draft content its published content - what a QuestionBank block of a live Riddle actually draws at view time - so the change reaches participants immediately: every Riddle using the bank is republished and re-draws its questions, even when nothing changed. The previously published content of each item is overwritten, and a pending item delete (question_bank_item_delete on a publ","read_only":false},{"name":"question_bank_item_add","title":"Add question bank item","description":"Adds ONE new question/item to a question bank; nothing existing is changed (question_bank_item_update replaces an item, question_bank_item_delete removes one). There is no universal item shape: read riddle://reference/question-bank/block-type-columns before the first add into a bank you have not populated - it lists the valid blockType values per Riddle type and the \"columns\" each expects (the blo","read_only":false},{"name":"question_bank_item_update","title":"Update question bank item","description":"Replaces the content of ONE existing question/item of a question bank entirely - not a merge: blockType, category, difficulty and columns must all be sent even when unchanged, and a column or value left out is gone from the draft. blockType is immutable: a different value is rejected rather than retyping the item (delete it with question_bank_item_delete and add a new one instead). Read the item w","read_only":false},{"name":"question_bank_discard_changes","title":"Discard question bank changes","description":"Throws away every unpublished change to a question bank's items at once, resetting each of them to its last published content. Irreversible - there is no undo and no copy of the discarded draft. A pending item delete comes back; an item ADDED since the last publish has no published state and is left alone, so this is not \"restore the bank as it was published\". Only items are affected: the title an","read_only":false},{"name":"question_bank_delete","title":"Delete question bank","description":"Deletes a question bank and every item it holds (its tags cleaned up exactly as question_bank_tag_remove does) - one item alone is question_bank_item_delete. Rejected with QUESTION_BANK_INTERDEPENDENCY while a Riddle of the bank's own project still references it - counting the DRAFT and, on a published Riddle, the live version too, so a block removed from a draft does not release the bank until th","read_only":false},{"name":"question_bank_item_delete","title":"Delete question bank item","description":"Deletes ONE question/item of a question bank and touches nothing else. On a never-published item the delete is immediate and permanent; on a published one it only leaves the DRAFT - a live Riddle keeps drawing that item until question_bank_publish purges it, and question_bank_discard_changes brings it back until then. Permanent once purged: there is no trash and no restore. Rejected for a public t","read_only":false},{"name":"question_bank_get_items","title":"Get question bank items","description":"Lists the items of a question bank - its DRAFT content by default, or its published items with published: true. Filter by search term, blockType, category or difficultyRange - the same filters a QuestionBank block draws with. A template id from question_bank_list(scope: \"templates\") reads too - that is how to preview its questions before duplicating it. Paginated {items, page, pageSize, total, has","read_only":true},{"name":"question_bank_tag_add","title":"Add tag to question bank","description":"Adds a tag to a question bank, by tagName or tagId from riddle_tag_list - exactly one of the two, as riddle_tag_add does. Question bank tags and Riddle tags are ONE set per project, not two: the same tag applies to banks and Riddles and has the same id in both, which is why the ids come from riddle_tag_list. Reuses the project's tag of that name or creates it, and re-tagging changes nothing. quest","read_only":false},{"name":"question_bank_tag_remove","title":"Remove tag from question bank","description":"Removes a tag from a question bank, by tagName or tagId from riddle_tag_list - exactly one of the two. Never creates anything: a tag the bank does not carry is an error. A tag nothing uses any more is deleted from the project, where \"nothing\" includes Riddles: a tag a Riddle still uses survives its last bank. Deleting a tagged bank cleans up the same way. This only ever takes the tag off THIS bank","read_only":false},{"name":"palette_get","title":"Get brand palette","description":"Reads the palettes - colors, fonts, button styles, background settings - of a Riddle: every palette it can use (the ones inherited from the account/project default preset included) with all of their values, which one is selected, which values this Riddle overrides, and the built-in palettes to start from. What each value does is riddle://reference/palette/fields. Mind the size: ~30 values per pale","read_only":true},{"name":"palette_customize","title":"Customize brand palette","description":"Changes the palette (colors, fonts, button styles, background) of ONE Riddle, as a path => value map, e.g. {\"bgColor\": \"#ffffff\", \"font.name\": \"Roboto\"} - the paths are palette_get's or riddle://reference/palette/fields. Never affects another Riddle: a palette inherited from the account/project default preset is not changed for the others, the values are stored as an override on this one. A built-","read_only":false},{"name":"integration_list","title":"List integrations","description":"Lists the Google Sheets and webhook integrations of a project as {items: [{id, type, name, connectedRiddles}]}. \"name\" is the value a build takes as publish.integrations.googlesheets / .webhook to connect that integration to a Riddle. A Google Sheet can only be connected in the Creator - with none listed, ask the user to add one there. A Riddle with a FileUpload form field cannot be published with","read_only":true},{"name":"riddle_builder_create","title":"Build a riddle","description":"Builds a new Riddle of any of the nine types from a build configuration: \"type\" says which kind (see that argument for what each one is and what it needs at a minimum), \"build\" carries the content. Everything a type accepts is described on the \"build\" fields themselves, marked with the types it belongs to; the exhaustive per-type shapes are in riddle://reference/riddle-builder/riddle-types, the bl","read_only":false},{"name":"riddle_builder_update","title":"Update a riddle","description":"Edits an existing Riddle of any type with the same build configuration riddle_builder_create takes - but as a merge, not a rebuild: only the fields you send are touched, an omitted one is left exactly as it is. Blocks are addressed by their \"id\", added with \"$create\": true, removed with \"$delete\": true and reordered with \"$blocksOrder\"; the same grammar edits a block's \"items\"/\"fields\" and a Perso","read_only":false},{"name":"riddle_builder_validate","title":"Validate a build configuration","description":"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, run against a scratch/deep-copied Riddle that is discarded before this returns - never persisted, never published, no event dispatched. A media URL in the build IS still checked for reachability with a live HEAD request (no content fe","read_only":true},{"name":"reference_get","title":"Get builder reference document","description":"Read this server's own documentation: the block types, form field types, result blocks, palette values and response shapes the other tools expect. Every \"riddle://reference/...\" URI named in a tool description, a response or an error message is a topic of this tool - pass it here to read that document. These are the authoritative parameter reference for the riddle_builder_* and palette_* tools: re","read_only":true},{"name":"stats_fetch","title":"Fetch riddle statistics","description":"Views/starts/submissions of one entity - \"namespace\" plus \"entityId\" says which (a project, a user, or a Riddle by UUID), \"view\" how deeply. \"totals\": one aggregate for the period. The response IS the entity's stats document: metrics sit in \"core_metrics\" under \"global_stats\" (a Riddle) or under \"stats\" (a user/project aggregate, or an old Riddle) - read only \"stats\" and a Riddle with real traffic","read_only":true},{"name":"project_list","title":"List projects","description":"Lists the projects this token has access to as {items, page, pageSize, total, hasMore} - the paging every listing of this server answers with (riddle://reference/concepts/response-envelope), here 25 per page, 100 max, so an account with many projects can be paged through; a project API token only ever returns its own project. Each entry is a trimmed summary (id, name, image): project_get adds your","read_only":true},{"name":"project_get","title":"Get project","description":"Returns one project by id - id, name, image and the authenticated user's permission matrix for it. The id comes from project_list or from the \"team\" of riddle_get. The project's default Riddle settings are NOT included; they are a large nested tree with its own tool, project_get_settings.","read_only":true},{"name":"project_get_settings","title":"Get project settings","description":"Returns the default Riddle settings every new Riddle of the project starts from - PUBLISHED and ENABLED only: \"publishSettings\" (privacy/DOI/OTP, email automation, tracking, data layer, ...) and \"embedSettings\" (iframe sizing, auto-scroll, ...), each holding only the areas whose \"isDefaultEnabled\"/\"isEnabled\" was on in the last published version. Never-published drafts and disabled areas are delib","read_only":true},{"name":"riddle_preview","title":"Preview a Riddle","description":"Shows the user the current DRAFT of a Riddle as a playable preview - the Riddle as it looks right now, published or not. Call it after riddle_builder_create or riddle_builder_update whenever the user wants to see the result (right after riddle_publish the draft and the live version are identical, so it shows what is live); do not call it on every edit of a multi-step build, once at the end is enou","read_only":true}],"server_info":{"name":"Riddle Creator","version":"1.0","description":"Build, edit, publish and analyse interactive content - quizzes, polls, personality tests, forms, predictors, minigames and stories - in the Riddle Creator account this connection is authorised for. Also manages projects, question banks, templates, tags, brand palettes and statistics.","icons":[{"src":"https://cdn.riddle.com/website/favicon.png","mimeType":"image/png","sizes":["196x196"]}],"websiteUrl":"https://www.riddle.com"},"category":"finance","tags":["news","project","automation"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":31897,"score":100,"indexable":true,"first_seen":"2026-08-20","stars":0,"badges":["official"],"sponsor":null,"page":"https://agentsindex.org/agents/com-riddle-creator/"}