We and selected third parties use cookies or similar technologies for technical purposes and, with your consent, to analyze how the site is used.

You can freely give, refuse or withdraw your consent at any time.

Riddle

MCP server by Riddle

Build, edit, publish and analyze quizzes, polls, forms and personality tests in Riddle from an AI chat.

OAuth sign-in (You sign in with the vendor the first time you connect)Streamable HTTP

Connect to Riddle

Riddle needs sign-in. Connect with its own URL:

https://www.riddle.com/creator/api/v3/mcp

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/riddle

About

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_linkWrites

    Create media upload link

  • media_deleteCan delete

    Delete media library file

  • riddle_template_createWrites

    Create riddle template

  • riddle_template_updateCan delete

    Update riddle template

  • riddle_template_listRead-only

    List riddle templates

  • riddle_template_public_listRead-only

    List public riddle templates

  • riddle_template_getRead-only

    Get riddle template

  • riddle_template_useWrites

    Create riddle from template

  • riddle_tag_listRead-only

    List riddle tags

  • riddle_tag_addWrites

    Add tag to riddles

  • riddle_tag_removeCan delete

    Remove tag from riddles

  • riddle_tag_deleteCan delete

    Delete riddle tag

Show 36 more tools
  • pingRead-only

    Ping the MCP server

  • riddle_listRead-only

    List riddles

  • riddle_getRead-only

    Get riddle

  • riddle_get_embed_codeRead-only

    Get riddle embed code

  • riddle_publishCan delete

    Publish or unpublish riddle

  • riddle_renameCan delete

    Rename riddle

  • riddle_deleteCan delete

    Delete riddle

  • riddle_moveCan delete

    Move riddle to another project

  • whoamiRead-only

    Show the connected account

  • question_bank_createWrites

    Create question bank

  • question_bank_listRead-only

    List question banks

  • question_bank_getRead-only

    Get question bank

  • question_bank_renameCan delete

    Rename question bank

  • question_bank_update_notesCan delete

    Update question bank notes

  • question_bank_duplicateWrites

    Duplicate question bank

  • question_bank_publishCan delete

    Publish question bank

  • question_bank_item_addWrites

    Add question bank item

  • question_bank_item_updateCan delete

    Update question bank item

  • question_bank_discard_changesCan delete

    Discard question bank changes

  • question_bank_deleteCan delete

    Delete question bank

  • question_bank_item_deleteCan delete

    Delete question bank item

  • question_bank_get_itemsRead-only

    Get question bank items

  • question_bank_tag_addWrites

    Add tag to question bank

  • question_bank_tag_removeCan delete

    Remove tag from question bank

  • palette_getRead-only

    Get brand palette

  • palette_customizeCan delete

    Customize brand palette

  • integration_listRead-only

    List integrations

  • riddle_builder_createWrites

    Build a riddle

  • riddle_builder_updateCan delete

    Update a riddle

  • riddle_builder_validateRead-only

    Validate a build configuration

  • reference_getRead-only

    Get builder reference document

  • stats_fetchRead-only

    Fetch riddle statistics

  • project_listRead-only

    List projects

  • project_getRead-only

    Get project

  • project_get_settingsRead-only

    Get project settings

  • riddle_previewRead-only

    Preview 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

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http riddle https://www.riddle.com/creator/api/v3/mcp
  1. 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

  1. Open Customize → Connectors, click + Add, then Add custom connector.
  2. Name it Riddle and paste this URL:
https://www.riddle.com/creator/api/v3/mcp
  1. 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

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://www.riddle.com/creator/api/v3/mcp and click Add.
  2. 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

  1. On chatgpt.com, go to Plugins, select +, then Add custom MCP server.
  2. Enter a name for the server.
  3. Under Connection, paste https://www.riddle.com/creator/api/v3/mcp as the server URL, then for authentication choose OAuth. ChatGPT sends you to Riddle to sign in.
  4. 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

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "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

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:

.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

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "riddle": {
      "serverUrl": "https://www.riddle.com/creator/api/v3/mcp"
    }
  }
}
  1. 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 riddle

Or edit ~/.codex/config.toml directly:

config.toml
[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/mcp

Then, 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

Badge preview, lightBadge preview, dark
Markdown
[![Riddle on mcp.tc](https://mcp.tc/i/riddle/badge.svg)](https://mcp.tc/i/riddle)
HTML
<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

HTML
<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

HTML
<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.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the Riddle card to your site.

Markdown
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
[![Riddle on mcp.tc](https://mcp.tc/i/riddle/badge.svg)](https://mcp.tc/i/riddle)
```

Reference: https://mcp.tc/embed

Change history

We read this server’s tool list every 3 hours and record what changes. Last read 18 Nov 2026, 05:37 UTC.

Follow Riddle and we’ll email you when something changes.

  1. , Automatic check

    2 tools changed.

    Details, 11 Nov 2026, 14:54 UTC

    Changed 2

    • riddle_builder_createinput schema
    • riddle_builder_updateinput schema
  2. , Automatic check

    2 tools changed.

    Details, 11 Nov 2026, 11:47 UTC

    Changed 2

    • riddle_builder_createinput schema
    • riddle_builder_updateinput schema
  3. , Automatic check

    2 tools changed.

    Details, 2 Nov 2026, 11:51 UTC

    Changed 2

    • riddle_builder_createinput schema
    • riddle_builder_updateinput schema
  4. , Automatic check

    17 tools changed.

    Hint changed: may modify data

    Details, 30 Oct 2026, 11:46 UTC

    Changed 17

    • integration_listdescription
      Before

      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 without a Google Sheets integration.

      After

      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 without a Google Sheets integration. Reads the stored records only - contacts neither Google nor any webhook.

    • media_deletehints
      • openWorldHint no changed to yes
    • media_upload_linkhints
      • openWorldHint no changed to yes
    • palette_customizehints
      • destructiveHint no changed to yes
    • question_bank_discard_changeshints
      • idempotentHint yes changed to no
    • question_bank_item_updatehints
      • idempotentHint yes changed to no
    • question_bank_publishdescription and hints
      Before

      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. 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.

      After

      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 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.

      • openWorldHint no changed to yes
      • idempotentHint yes changed to no
    • question_bank_renamehints
      • destructiveHint no changed to yes
      • idempotentHint yes changed to no
    • question_bank_update_noteshints
      • idempotentHint yes changed to no
    • riddle_deletehints
      • openWorldHint no changed to yes

    riddle_get_embed_code riddle_preview riddle_rename riddle_template_create riddle_template_update riddle_template_use stats_fetch

  5. , Automatic check

    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_duplicateWrites

      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.

    • question_bank_item_addWrites

      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 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 delete

      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 template id. Needs full access: riddle://reference/concepts/access.

    • question_bank_item_updateCan delete

      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 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 delete

      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. 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_renameWrites

      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.

    • question_bank_tag_addWrites

      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. 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 delete

      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; 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 delete

      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 unpublished change. Rejected for a public template id. Needs full access: riddle://reference/concepts/access.

    • riddle_tag_addWrites

      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 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 delete

      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 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_item

      Adds 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_manage

      Everything 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_tag

      Adds 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_tag

      Puts 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

    • pinghints
      • idempotentHint not set changed to yes
    • question_bank_createdescription
      Before

      Creates 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.

      After

      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 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 hints
      Before

      Deletes a question bank or ONE of its items - "target" says which, and nothing else deletes either. target "bank" removes the bank and every item it holds (its tags cleaned up exactly as question_bank_tag(action: "remove") does), and is 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. 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…

      After

      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 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

      Before

      Delete question bank or item

      After

      Delete question bank

      • Removed parameters: target questionBankItemId
      • No longer required: target
      • Description of questionBankId
        Before

        The ID of the question bank to delete, or of the bank the item belongs to.

        After

        The ID of the question bank to delete.

    • question_bank_discard_changesdescription
      Before

      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 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.

      After

      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 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_getdescription
      Before

      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. "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").

      After

      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. "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_listdescription
      Before

      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 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 with question_bank_get…

      After

      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 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_gethints
      • idempotentHint not set changed to yes
    • riddle_builder_createhints
      • openWorldHint no changed to yes
    • riddle_builder_updatehints
      • destructiveHint no changed to yes
      • openWorldHint no changed to yes
    • riddle_builder_validatehints
      • openWorldHint no changed to yes

    riddle_move riddle_rename riddle_tag_delete riddle_tag_list

  6. , Automatic check

    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.