Riddle
MCP server by Riddle
Build, edit, publish and analyze quizzes, polls, forms and personality tests in Riddle from an AI chat.
Connect to Riddle
Riddle needs sign-in. Connect with its own URL:
Your client opens Riddle’s sign-in the first time you use it. The token stays between your client and Riddle.
Share this server
Opens this page, with the URL and setup steps.
mcp.tc/i/riddleAbout
Connects an AI assistant to the Riddle creator API. You can list existing Riddles, build new quizzes, polls, forms and personality tests, edit them, and analyze results from a chat. Actions available through the Riddle API can be triggered through the assistant.
The server is hosted at https://www.riddle.com/creator/api/v3/mcp and uses streamable HTTP. A Riddle account is required. Users sign in with OAuth in the browser, and the token inherits that user's project roles and permissions. A key-in-URL option exists for headless agents, but OAuth is recommended.
What you can do
- List existing Riddles in your account
- Build quizzes, polls, forms and personality tests
- Edit existing Riddles
- Analyze Riddle results and stats
- Sign in with your own Riddle account via OAuth
Tools 48
media_upload_linkWritesCreate media upload link
media_deleteCan deleteDelete media library file
riddle_template_createWritesCreate riddle template
riddle_template_updateCan deleteUpdate riddle template
riddle_template_listRead-onlyList riddle templates
riddle_template_public_listRead-onlyList public riddle templates
riddle_template_getRead-onlyGet riddle template
riddle_template_useWritesCreate riddle from template
riddle_tag_listRead-onlyList riddle tags
riddle_tag_addWritesAdd tag to riddles
riddle_tag_removeCan deleteRemove tag from riddles
riddle_tag_deleteCan deleteDelete riddle tag
Show 36 more tools
pingRead-onlyPing the MCP server
riddle_listRead-onlyList riddles
riddle_getRead-onlyGet riddle
riddle_get_embed_codeRead-onlyGet riddle embed code
riddle_publishCan deletePublish or unpublish riddle
riddle_renameCan deleteRename riddle
riddle_deleteCan deleteDelete riddle
riddle_moveCan deleteMove riddle to another project
whoamiRead-onlyShow the connected account
question_bank_createWritesCreate question bank
question_bank_listRead-onlyList question banks
question_bank_getRead-onlyGet question bank
question_bank_renameCan deleteRename question bank
question_bank_update_notesCan deleteUpdate question bank notes
question_bank_duplicateWritesDuplicate question bank
question_bank_publishCan deletePublish question bank
question_bank_item_addWritesAdd question bank item
question_bank_item_updateCan deleteUpdate question bank item
question_bank_discard_changesCan deleteDiscard question bank changes
question_bank_deleteCan deleteDelete question bank
question_bank_item_deleteCan deleteDelete question bank item
question_bank_get_itemsRead-onlyGet question bank items
question_bank_tag_addWritesAdd tag to question bank
question_bank_tag_removeCan deleteRemove tag from question bank
palette_getRead-onlyGet brand palette
palette_customizeCan deleteCustomize brand palette
integration_listRead-onlyList integrations
riddle_builder_createWritesBuild a riddle
riddle_builder_updateCan deleteUpdate a riddle
riddle_builder_validateRead-onlyValidate a build configuration
reference_getRead-onlyGet builder reference document
stats_fetchRead-onlyFetch riddle statistics
project_listRead-onlyList projects
project_getRead-onlyGet project
project_get_settingsRead-onlyGet project settings
riddle_previewRead-onlyPreview a Riddle
Read from the live server on 17 Nov 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.
Example prompts
List my most recent Riddles.
Create a five-question quiz about European capitals.
Build a personality test with three result pages.
Show the stats for my latest poll.
Set up
Every client connects to riddle.com, and Riddle asks you to sign in the first time. Pick yours; the page remembers your choice.
Claude Code
- Run this in a terminal, in your project folder:
claude mcp add --transport http riddle https://www.riddle.com/creator/api/v3/mcp- Start Claude Code, type
/mcp, pick riddle and choose Authenticate. A browser window opens for the Riddle sign-in.
Add --scope user to make it available in every project, not just this one.
Claude Desktop
- Open Customize → Connectors, click + Add, then Add custom connector.
- Name it Riddle and paste this URL:
https://www.riddle.com/creator/api/v3/mcp- Click Add, then Connect, and sign in when Riddle asks.
Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.
claude.ai
- Open the connector form on claude.ai. This button fills in the name and URL for you:
Add to claude.ai (opens in a new tab)
- Check that the URL reads
https://www.riddle.com/creator/api/v3/mcpand click Add. - Click Connect and sign in when Riddle asks.
Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.
ChatGPT
- On chatgpt.com, go to Plugins, select +, then Add custom MCP server.
- Enter a name for the server.
- Under Connection, paste
https://www.riddle.com/creator/api/v3/mcpas the server URL, then for authentication choose OAuth. ChatGPT sends you to Riddle to sign in. - Check I understand and want to continue, then select Create as a plugin.
Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).
Cursor
Add to Cursor (opens in a new tab)
Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{
"mcpServers": {
"riddle": {
"url": "https://www.riddle.com/creator/api/v3/mcp"
}
}
}Cursor shows Needs authentication next to the server. Click the button beside it to sign in.
VS Code
Install in VS Code (opens in a new tab)
Or from a terminal:
code --add-mcp '{"name":"riddle","type":"http","url":"https://www.riddle.com/creator/api/v3/mcp"}'Or commit it to the repo in .vscode/mcp.json:
{
"servers": {
"riddle": {
"type": "http",
"url": "https://www.riddle.com/creator/api/v3/mcp"
}
}
}VS Code asks you to sign in the first time the server starts.
Devin Desktop
- Add it to
~/.config/devin/mcp_config.json(macOS and Linux) or%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"riddle": {
"serverUrl": "https://www.riddle.com/creator/api/v3/mcp"
}
}
}- Refresh the MCP server list in Cascade and sign in when asked.
Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.
Codex
codex mcp add riddle --url https://www.riddle.com/creator/api/v3/mcp
codex mcp login riddleOr edit ~/.codex/config.toml directly:
[mcp_servers.riddle]
url = "https://www.riddle.com/creator/api/v3/mcp"Gemini CLI
gemini mcp add --transport http riddle https://www.riddle.com/creator/api/v3/mcpThen, inside Gemini CLI, run /mcp auth riddle to sign in.
This adds it to the current project. Add -s user to use it everywhere.
Any client
Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI’s settings file.
{
"mcpServers": {
"riddle": {
"type": "http",
"url": "https://www.riddle.com/creator/api/v3/mcp"
}
}
}Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.
Client only starts local servers? Bridge it with npx -y mcp-remote https://www.riddle.com/creator/api/v3/mcp.
Embed
Show Riddle in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work
The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.
README badge
[](https://mcp.tc/i/riddle)<a href="https://mcp.tc/i/riddle"><img src="https://mcp.tc/i/riddle/badge.svg" alt="Riddle on mcp.tc" height="20"></a>It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.
Website card
<script src="https://mcp.tc/w/riddle.js" async></script>The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.
iframe
<iframe src="https://mcp.tc/embed/riddle" title="Riddle on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.
JSON
The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).
https://mcp.tc/i/riddle.jsonAI prompt
Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the Riddle card to your site.
Add the mcp.tc card for Riddle, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.
Put this tag where the card should appear. The card renders right before it:
```html
<script src="https://mcp.tc/w/riddle.js" async></script>
```
To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.
```html
<div data-mcptc="riddle"><a href="https://mcp.tc/i/riddle">Riddle on mcp.tc</a></div>
```
Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.
If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).
For a README or other Markdown docs, use the badge instead:
```markdown
[](https://mcp.tc/i/riddle)
```
Reference: https://mcp.tc/embedChange history
We read this server’s tool list every 3 hours and record what changes. Last read 18 Nov 2026, 05:37 UTC.
-
2 tools changed.
Details, 11 Nov 2026, 14:54 UTC
Changed 2
riddle_builder_createinput schemariddle_builder_updateinput schema
-
2 tools changed.
Details, 11 Nov 2026, 11:47 UTC
Changed 2
riddle_builder_createinput schemariddle_builder_updateinput schema
-
2 tools changed.
Details, 2 Nov 2026, 11:51 UTC
Changed 2
riddle_builder_createinput schemariddle_builder_updateinput schema
-
17 tools changed.
Hint changed: may modify data
Details, 30 Oct 2026, 11:46 UTC
Changed 17
integration_listdescriptionBeforeLists 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 without a Google Sheets integration.
AfterLists 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 without a Google Sheets integration. Reads the stored records only - contacts neither Google nor any webhook.
media_deletehintsopenWorldHintno changed to yes
media_upload_linkhintsopenWorldHintno changed to yes
palette_customizehintsdestructiveHintno changed to yes
question_bank_discard_changeshintsidempotentHintyes changed to no
question_bank_item_updatehintsidempotentHintyes changed to no
question_bank_publishdescription and hintsBeforeMakes 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.The previously published content of each item is overwritten, and a pending item delete (question_bank_item_delete on a published item) is purged for good at this point. A bank with unpublished changes still works in a block, it just draws its last published state; question_bank_discard_changes is the opposite step. Read question_bank_get_items with and without published: true first when unsure what will change. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.AfterMakes 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 published item) is purged for good at this point. A bank with unpublished changes still works in a block, it just draws its last published state; question_bank_discard_changes is the opposite step. Read question_bank_get_items with and without published: true first when unsure what will change. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
openWorldHintno changed to yesidempotentHintyes changed to no
question_bank_renamehintsdestructiveHintno changed to yesidempotentHintyes changed to no
question_bank_update_noteshintsidempotentHintyes changed to no
riddle_deletehintsopenWorldHintno changed to yes
riddle_get_embed_coderiddle_previewriddle_renameriddle_template_createriddle_template_updateriddle_template_usestats_fetch -
11 tools added, 4 tools removed and 14 tools changed.
Hint changed: may modify data, New tool marked destructive
Details, 29 Oct 2026, 17:47 UTC
Added 11
question_bank_duplicateWritesCopies 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.
question_bank_item_addWritesAdds 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 blockTypeColumns listing is that document, not a tool). The item lands in the bank's DRAFT - question_bank_publish is what makes it something a QuestionBank block draws. "hasChanges" in the response says whether the bank now has unpublished changes. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
question_bank_item_deleteCan deleteDeletes 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 template id. Needs full access: riddle://reference/concepts/access.
question_bank_item_updateCan deleteReplaces 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 with question_bank_get_items first and send it back with its value ids intact. The change lands in the bank's DRAFT - question_bank_publish makes it live, question_bank_discard_changes throws every unpublished change away again. "hasChanges" in the response says whether the bank now has unpublished changes. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
question_bank_publishCan deleteMakes 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. The previously published content of each item is overwritten, and a pending item delete (question_bank_item_delete on a published item) is purged for good at this point. A bank with unpublished changes still works in a block, it just draws its last published state; question_bank_discard_changes is the opposite step. Read question_bank_get_items with and without published: true first when unsure what will change. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
question_bank_renameWritesSets 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.
question_bank_tag_addWritesAdds 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. question_bank_tag_remove takes it off again. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
question_bank_tag_removeCan deleteRemoves 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; riddle_tag_delete removes the label from the project itself. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
question_bank_update_notesCan deleteReplaces 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 unpublished change. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
riddle_tag_addWritesPuts 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 one project and therefore works only for that project's Riddles. Re-tagging changes nothing and no tag needs a publish. There is no projectId here: a tag lives in the project of the Riddle it is put on, which is where the scope comes from. Returns the tag plus all tags of the Riddle, and with UUIDs the {bulk, operation, summary, results} envelope with one entry per Riddle, a failure (no edit permission, a tagId from another project) reported as that entry's "error" without stopping the others. Only if the Riddle's origin.writableByThisKey is true (riddle_get, riddle_list): riddle://reference/…
riddle_tag_removeCan deleteTakes 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 uses it - so a tag rarely has to be deleted by hand, and a tag removed that way is gone for good (re-adding creates a new one with a new id). Returns the tag plus all remaining tags of the Riddle, and with UUIDs the {bulk, operation, summary, results} envelope with one entry per Riddle, a failure reported as that entry's "error" without stopping the others. Only if the Riddle's origin.writableByThisKey is true (riddle_get, riddle_list): riddle://reference/concepts/access.
Removed 4
question_bank_itemAdds or replaces ONE question/item of a question bank, by "action" - deleting one is question_bank_delete. 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 blockTypeColumns listing is that document, not a tool). "update" replaces the item's content entirely, so blockType, category, difficulty and columns must all be sent even when unchanged, and blockType is immutable: a different value is rejected rather than retyping the item (delete it and add a new one instead). Both change the bank's DRAFT - question_bank_manage(action: "publish") is what makes a change something a QuestionBank block draws, and question_bank_discard_changes throws every unpublished change away again. "hasChanges" in the response says whether the bank now has unpublished changes. Rejected for a public template id. Needs full ac…
question_bank_manageEverything that acts on a question bank as a whole, by "action" - the items themselves are question_bank_item, and the two calls that only destroy are question_bank_delete and question_bank_discard_changes. A public template id is accepted for "duplicate" only and rejected by every other action. "rename" sets the title and "updateNotes" replaces the plain-text maintainer notes (never shown to participants): both are metadata rather than DRAFT content, so they take effect immediately AND permanently, are unaffected by publishing or discarding and never count as an unpublished change. "publish" makes every item's draft content its published content - what a QuestionBank block actually draws at view time - and is when a pending item delete is finally purged; a bank with unpublished changes still works in a block, it just draws its last published state. "duplicate" copies the bank and all of its items into a new independent bank (editing one never affects the other) in projectId or the ke…
question_bank_tagAdds a tag to a question bank or removes one from it, by tagName or tagId from riddle_tag_list - exactly one of the two, as riddle_tag 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. "add" reuses the project's tag of that name or creates it, and re-tagging changes nothing. "remove" never creates anything - a tag the bank does not carry is an error - and 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 adds or removes the tag on THIS bank; riddle_tag_delete removes the label from the project itself. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
riddle_tagPuts a tag on Riddles or takes it off again, by "action" - ONE assignment per Riddle, never the tag itself (riddle_tag_list reads the labels of a project, riddle_tag_delete removes one). "add" 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 one project and therefore works only for that project's Riddles; re-tagging changes nothing and needs no publish. "remove" takes the tag off again 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, unless a question bank still uses it - so a tag rarely has to be deleted by hand. There is no projectId here: a tag lives in the project of the Riddle it is put on, which is where the scope comes from. Both actions return the tag plus all tags of the Riddle, and with UUIDs the {bulk, operation, summary, resu…
Changed 14
pinghintsidempotentHintnot set changed to yes
question_bank_createdescriptionBeforeCreates a new, empty question bank for the given Riddle type ("Quiz" or "Poll"). Add items with
question_bank_item(action: "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 from Riddles of that same project, so pass the projectId of the project the Riddle belongs to; omitting it creates the bank in the project the API key is scoped to. Needs full access: riddle://reference/concepts/access.AfterCreates 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 from Riddles of that same project, so pass the projectId of the project the Riddle belongs to; omitting it creates the bank in the project the API key is scoped to. Needs full access: riddle://reference/concepts/access.
question_bank_deletedescription, title, input schema and hintsBeforeDeletes a question bank
or ONE of its items - "target" says which,andnothing else deletes either. target "bank" removes the bank andevery item it holds (its tags cleaned up exactly asquestion_bank_tag(action: "remove") does), andisrejectedwith 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 that Riddle is republished; read "deletingABank" in riddle://reference/question-bank/overview before deleting one.target "item" takes questionBankItemId 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_manage(action: "publish") purges it, and question_bank_discard_changes brings it back until then. Both are permanent for the caller:there is no trash and no restore.Reject…AfterDeletes 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 that Riddle is republished; read "deletingABank" in riddle://reference/question-bank/overview before deleting one. Permanent: there is no trash and no restore. Rejected for a public template id - a template is copied with question_bank_duplicate, never deleted. Needs full access: riddle://reference/concepts/access.
title
BeforeDelete question bank
or itemAfterDelete question bank
- Removed parameters:
targetquestionBankItemId - No longer required:
target - Description of
questionBankIdBeforeThe ID of the question bank to
delete, or of the bank the item belongs to.AfterThe ID of the question bank to delete.
- Removed parameters:
question_bank_discard_changesdescriptionBeforeThrows 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 and the notes are metadata outside the draft/publish split and never change here. Read the two sides before calling - question_bank_get_items reads the draft, the same call with published: true reads exactly the state this resets to - and prefer
question_bank_manage(action: "publish")whenever the draft is what should survive. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.AfterThrows 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 and the notes are metadata outside the draft/publish split and never change here. Read the two sides before calling - question_bank_get_items reads the draft, the same call with published: true reads exactly the state this resets to - and prefer question_bank_publish whenever the draft is what should survive. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.
question_bank_getdescriptionBeforeRetrieves 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. "categories" and "blockTypeCategoryMap" are different slices and can disagree: "categories" comes from every DRAFT item, while "blockTypeCategoryMap" (categories per blockType) counts only PUBLISHED ones - a category used only by unpublished items is in "categories" but missing for its blockType there until
question_bank_manage(action: "publish").AfterRetrieves 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. "categories" and "blockTypeCategoryMap" are different slices and can disagree: "categories" comes from every DRAFT item, while "blockTypeCategoryMap" (categories per blockType) counts only PUBLISHED ones - a category used only by unpublished items is in "categories" but missing for its blockType there until question_bank_publish.
question_bank_listdescriptionBeforeLists 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
question_bank_manage(action: "duplicate")to get real content immediately instead of starting empty. It takes riddleType and nothing else (a handful of them, nothing to page or search) and answers with id, title, PUBLISHED "itemCount", DRAFT "draftItemCount", which blockTypes those items are (null when that cannot be told yet) and a few example categories out of "categoryCount". A template that was never published reports "itemCount": 0 however many questions it holds - judge its real size by "draftItemCount", the number a duplicate would give you, and read the chosen id withquestion_bank_get…AfterLists 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 question_bank_duplicate to get real content immediately instead of starting empty. It takes riddleType and nothing else (a handful of them, nothing to page or search) and answers with id, title, PUBLISHED "itemCount", DRAFT "draftItemCount", which blockTypes those items are (null when that cannot be told yet) and a few example categories out of "categoryCount". A template that was never published reports "itemCount": 0 however many questions it holds - judge its real size by "draftItemCount", the number a duplicate would give you, and read the chosen id with question_bank_get and question_bank_…
reference_gethintsidempotentHintnot set changed to yes
riddle_builder_createhintsopenWorldHintno changed to yes
riddle_builder_updatehintsdestructiveHintno changed to yesopenWorldHintno changed to yes
riddle_builder_validatehintsopenWorldHintno changed to yes
riddle_moveriddle_renameriddle_tag_deleteriddle_tag_list -
Tracking started: 41 tools.
FAQ
Can I paste mcp.tc/i/riddle into my MCP client?
No. mcp.tc links are pages, not server addresses. Connect with https://www.riddle.com/creator/api/v3/mcp, so your client talks to Riddle directly. The sign-in token only works there anyway. The quick link is for sharing: it opens this page, with setup steps for every client.
Does Riddle need an API key or a sign-in?
Yes, you need a Riddle account. The first time your client connects, it opens Riddle’s sign-in page. The token goes straight to the server’s own URL, never through mcp.tc.
Is Riddle a remote or a local server?
Remote. Riddle hosts it at https://www.riddle.com/creator/api/v3/mcp, and it speaks Streamable HTTP. There’s nothing to install.
What can Riddle do?
It has 48 tools, including media_upload_link, media_delete and riddle_template_create. You can list existing Riddles in your account, build quizzes, polls, forms and personality tests and edit existing Riddles.
Which clients can use it?
Remote MCP clients that sign in with OAuth, as long as they are registered with Riddle in advance or identify themselves with a Client ID Metadata Document (CIMD): Riddle doesn’t offer open Dynamic Client Registration. Check Riddle’s own setup guide for your client.
Does mcp.tc track changes to Riddle?
Yes. Riddle’s History tab shows each change we find to its tools, down to descriptions and parameters, plus new versions and edits by its owner. Follow the listing to get an email when it changes.
Who wrote this page?
mcp.tc’s robot read Riddle’s own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.
mcp.tc isn’t affiliated with Riddle. This page was built from Riddle’s public metadata, last checked on 17 Nov 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.