MartechDB
MartechDB
Toggle sidebar

Riddle MCP server

riddle.com

Yes. Riddle publishes an official MCP server at https://www.riddle.com/creator/api/v3/mcp. It's hosted. It offers 48 tools. We last checked it on 22 Nov 2026.

Official MCP server
Hosted
Sign-in: see vendor docs

Official: published in the official MCP Registry as com.riddle/creator, a name only the owner of riddle.com can publish under. Checked 22 Nov 2026. Maintained by Stuart Brameld.

Key facts

As of 22 Nov 2026, Riddle's official MCP server scores 74/100 (provisional) on MartechDB's Agent Readiness Index (v1.1). It answered 55 of our 55 checks in the last 90 days and lists 48 tools.

How the Agent Readiness Index works · Wrong? Suggest a correction

Riddle MCP server review

74/100

Riddle's Riddle scores 74/100 on MartechDB's Agent Readiness Index: easy to connect an AI agent to, with a few gaps.

The good

  • Hosted by Riddle: connect by URL, with nothing to install

  • Documented, with 48 tools known

  • Published to the official MCP Registry

  • Answered 100% of our checks in the last 90 days

  • Free trial

  • No card needed to start

  • Included in the plan, at no extra cost

The bad

  • Nothing we've found.

Not checked yet: how you sign in. Anything not checked scores nothing.

Official MCP server

Riddle

Build, publish and analyze quizzes, polls, forms and personality tests. Riddle account required.

Address
https://www.riddle.com/creator/api/v3/mcp
Runs
Hosted
Sign-in
Sign-in: see vendor docs
Vendor docs
Cost to use
Plan: Every plan, free trial included · Free trial · No card needed
20 media upload links per account per 5 minutes
From Riddle's own page, pricing from this page
Official MCP Registry
Listed as com.riddle/creator · published 20 Aug 2026
How we know it's official
  • Published in the official MCP Registry as com.riddle/creator, a name only the owner of riddle.com can publish under.
Checked 22 Nov 2026.
Tools
48 tools · listed 22 Nov 2026
First seen
20 Aug 2026
Last checked
Reachable ·
16 Nov 2026: reachable
17 Nov 2026: reachable
18 Nov 2026: reachable
19 Nov 2026: reachable
20 Nov 2026: reachable
21 Nov 2026: reachable
22 Nov 2026: reachable
Uptime
100% · 55 of 55 checks reachable since 1 Oct 2026

Riddle tools (48)

As the server lists them. Names and descriptions are the vendor's own.

  • media_upload_link Create media upload link

    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 the links up front, and never store or share one. Check the file BEFORE minting a link, since a link a rejected file burns is gone: an image, a video or an audio file, at most 10 MB (some environments cap lower - "maxBytes" and "allowedTypes" in the answer are the authoritative pair). Pass the "project" you will build in. Returns {uploadUrl, expiresAt (UTC), singleUse, maxBytes, allowedTypes, project, usage, requiresNetworkAccessTo}. POST the file to "uploadUrl" as multipart/form-data under the field name "file" - "usage" is that command ready to run, e.g. curl -F 'file=@/path/to/image.png'…

  • media_delete Delete media library file
    Can delete or overwrite

    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_builder_update, then riddle_publish so the change is live) and delete afterwards. Unused is a property of the file across the whole ACCOUNT, not of one Riddle: several Riddles can use it and any one of them keeps it alive, and a file the Creator lists as in use cannot be forced out from here either. Not reversible, no undo, and the id is not reused, so anything still pointing at the file stops resolving - ask the user before calling this. Returns {deleted: true, mediaId, name, type, size}. Without full access only files in the "AI Uploads" folder (media_upload_link's destination): riddle://refe…

  • riddle_template_create Create riddle template

    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, type, category, isPublic, isQuickCreate, blocksCount, image, icon, createdAt, riddle}. Requires the template-create permission in the Riddle's project. Without full access only for a Riddle whose origin.writableByThisKey is true: riddle://reference/concepts/access.

  • riddle_template_update Update riddle template
    Can delete or overwrite

    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_create. Without full access only for a Riddle whose origin.writableByThisKey is true: riddle://reference/concepts/access.

  • riddle_template_list List riddle templates
    Read-only

    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, image, icon, createdAt, riddle, isPublic, isQuickCreate}], total} - not paginated, so "total" is simply how many there are - without the build configuration - read that with riddle_template_get, or hand the id straight to riddle_template_use.

  • riddle_template_public_list List public riddle templates
    Read-only

    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, isPublic}]}, total} - the one listing here that is grouped rather than a flat "items" - and without the build configuration, which is riddle_template_get (or hand the id straight to riddle_template_use).

  • riddle_template_get Get riddle template
    Read-only

    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 from it - and so it starts out on the template's whole preset, layout included, with your build config on top. The design comes along in "preset", which carries the preset settings and the palette; "preset.paletteValues" is included whenever that palette is not an unmodified built-in one, so a custom (or customized) palette rebuilds directly. On an unmodified built-in palette there is no "paletteValues" at all rather than a partial one: "preset.palette" names it in full (e.g. "Forest") and its colors/fonts come from riddle://reference/palette/built-in-palettes, matched by "name". Not changing…

  • riddle_template_use Create riddle from template

    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 - riddle_publish makes it live - except that Riddles the template embeds or that depend on it (a Form, a Leaderboard) are copied and published right away, and so is the new Riddle when one of them depends on it. Returns it in the standard build-configuration envelope, and takes riddle_get's "omit" to leave sections of it out. Requires the template-use permission plus Riddle-create in the target project.

  • riddle_tag_list List riddle tags
    Read-only

    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" in one project is a different tag from the one of that name in another. "count" counts RIDDLES and "bankCount" question banks, so "count": 0 alone never means unused - a tag is free of carriers only when both are 0, which is what riddle_tag_delete requires. Read this before riddle_tag_add, which creates a tag it does not find, to tag with the name a project already has rather than a second one beside it.

  • riddle_tag_add Add tag to riddles

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

Connect your AI to Riddle

Add the official Riddle MCP server to Claude, ChatGPT or your editor.

Connect Riddle MCP to Claude

Claude.ai and Claude Desktop

  1. Open Customize, then Connectors.

  2. Click +, then Add custom connector.

  3. Name it Riddle, paste the address below and click Add.

Claude Code

Riddle MCP server questions

Does Riddle have an official MCP server?

Yes. Riddle publishes its MCP server itself. It's in the official MCP Registry under Riddle's own domain. MartechDB only lists servers a vendor publishes, never community copies.

What is the Riddle MCP server URL?

The address is https://www.riddle.com/creator/api/v3/mcp.

How do I connect Riddle MCP to Claude, ChatGPT or Cursor?

In Claude, add https://www.riddle.com/creator/api/v3/mcp as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http riddle https://www.riddle.com/creator/api/v3/mcp

What can the Riddle MCP server do?

It offers 48 tools, including media_upload_link, media_delete, riddle_template_create, riddle_template_update and riddle_template_list (as listed on 22 Nov 2026). 21 are marked read-only and 18 can delete or overwrite data.

Is the Riddle MCP server in the official MCP Registry?

Yes, as com.riddle/creator.

Is the Riddle MCP server working?

Yes. It answered our most recent check. We last checked it on 22 Nov 2026.

What are the alternatives to Riddle's MCP server?

In Marketing automation, the most agent-friendly alternatives with an official MCP server are Kit (94/100), GetResponse (94/100), Quentn (91/100), Brevo (89/100) and vbout (89/100). Riddle scores 74/100 on the same index.

Alternatives to Riddle's MCP server

Vendors in Marketing automation with an official MCP server, the most agent-friendly first. Riddle scores 74/100.

Compare all 52 Marketing automation vendors →

Change history

What we've seen change for Riddle, newest first.

  1. Riddle: Riddle: 11 tools added, 4 removed (now 48)

  2. Riddle: Riddle: 3 tools added (now 41)

Use with AI

Connect your AI to MartechDB

Then ask it about Riddle, or any of the 1,850 marketing tools with an official MCP server. Free, no sign-in.

Claude.ai and Claude Desktop

  1. Open Customize, then Connectors.

  2. Click +, then Add custom connector.

  3. Name it MartechDB, paste the address below and click Add. There's no sign-in.

The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.

Show that your MCP server is verified

If you work at Riddle, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.

Official MCP server, verified by MartechDB
HTML
Markdown

Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.