Riddle MCP Server

Your quiz maker, inside your AI chat

The Riddle MCP server connects your Riddle account to Claude, Cursor, VS Code and any MCP client. Describe the quiz, poll or lead form you need and it lands in your account, on brand and ready to embed.

MCP server URL https://www.riddle.com/creator/api/v3/mcp
Connect to Claude Start free trial
Trusted by thousands of brands

One URL, every MCP client

  • Claude
  • Claude Code
  • Cursor
  • VS Code
  • Any MCP client

If your AI app speaks MCP, it speaks Riddle. Each person signs in with their own Riddle account, so there are no API keys to copy around and no shared credentials in a config file.

How to connect Riddle to Claude

Three steps, about two minutes, no installation. The server is remote, so there is nothing to run on your machine.

  1. Add the connector. In Claude, go to Settings > Connectors > Add custom connector. Name it Riddle MCP and paste the URL https://www.riddle.com/creator/api/v3/mcp. For a whole team, add it under Organization settings > Connectors instead.
  2. Sign in. Click connect and authorize with your Riddle account. Everyone uses their own login, and their project roles and AI permissions carry over unchanged.
  3. Ask for what you need. Try “list my latest published Riddles” to check the connection, then go straight to the real job: “Turn this article into a five-question quiz with a lead form and publish it.”

Prefer an MCP key over signing in? Append it to the URL as a path segment instead. The MCP documentation covers both routes, plus every tool and parameter.

What you can build from a chat

All nine Riddle types are available through the MCP server, with the same blocks, scoring and design options you get in the Creator.

Quiz

Scored quizzes with seven question types and results by percentage range.

Poll & Survey

Polls and surveys with Matrix, NPS, Swiper, Tier List, Rate It and more.

Personality Test

“Which one fits you” tests that recommend a product, a plan or a next read.

Lead Form

Forms with 18 field types, GDPR consent and double opt-in.

Predictor

Score and winner prediction games for match days and tournaments.

Leaderboard

Public rankings across up to ten quizzes, predictors or minigames.

Minigame

Slot Machine, Wheel Spinner and Sudoku, scored and brandable.

Story

Content sequences with media, quotes, interactive graphics and an optional form gate.

Placeholder

One embed that decides by rule, tag or time window which Riddle actually shows.

The builder tools accept far more than a list of questions: branching logic on quizzes, polls and forms, design presets and brand palettes, a Question Bank that serves randomized questions at view time, leaderboard connections, and publish automation covering double opt-in, email follow-ups, tracking and integrations. It is the full power of the Riddle Creator, driven from your chat.

Prompts to start with

Copy one, paste it into your AI app, answer the follow-up questions. Each of these is a real job the server carries out end to end.

Turn this blog post into a five-question quiz with a lead form and publish it.
Build a “which plan fits me” personality test that links each result to its pricing page.
Create a prediction game plus leaderboard for our next match day.
Restyle all quizzes tagged ‘summer’ to our new brand colors and republish them.
How did last week’s campaign quizzes perform? Show views, starts and submissions per day.
Build a newsletter signup form with GDPR consent and double opt-in.
Set up a daily quiz contest with a ranked leaderboard, one entry per participant.
Find the drop-off questions in this quiz and fix them.

12 built-in workflows. Zero prompt engineering.

The server ships ready-made workflows that chain the right tools in the right order and ask you only for what they cannot know: your brand colors, the URL, the project. Pick one in your MCP client instead of describing the whole job.

Build

  • Lead-gen quizEntertaining questions, a form before the result, optional double opt-in, published and ready to embed.
  • Lead formNewsletter, registration or contact form with the right field types, consent and a confirmation email.
  • Product recommenderA personality test where every product is an outcome and every result links to its page.
  • Gated content storyA teaser sequence, a form gate in the middle, the asset behind it.
  • Predictor with leaderboardA prediction game, a connected leaderboard and the scoring rules.
  • Quiz contest with leaderboardTimed and scored questions, one entry per participant, a live ranking.

Manage & optimize

  • Restyle to brandApplies your colors and fonts, then publishes so the change reaches the embed.
  • Organize libraryFinds Riddles by filter, tags them, publishes or unpublishes the set, moves them once the move is verified.
  • Localize a RiddleCreates the translated counterpart with the right language setting and keeps the two in sync.
  • Set up trackingWires up tracking networks, events and data layer pushes, then publishes.
  • Analyze campaign performanceCollects a campaign’s Riddles, pulls views, starts and submissions plus the daily trend, and turns it into a funnel.
  • Optimize against statsFinds the drop-offs in a Riddle, proposes fixes, applies them as an edit and publishes.

Under the hood

Built for agents, not just for chats. The numbers matter most when something runs unattended over many calls.

62tools across nine categories: build, edit, publish, organize, design, analyze
67reference documents the AI reads on demand, so it configures blocks instead of guessing
100Riddles per bulk call to publish, tag, move or delete in one go
20build configurations dry-run per validation call, before anything is created

Every Riddle can be read back as the same build configuration the builder tools accept, so an agent can inspect an existing Riddle, change one detail and rebuild it. Edits are merges, not rebuilds: only what you send changes. And responses are trimmable, so a long-running agent does not pay for parts of the answer it will never read.

Dry-run validation (riddle_builder_validate) is available on Business and Enterprise plans.

Safe by design

The questions your IT and legal teams will ask, answered up front.

Drafts by default

A new Riddle is created as a draft unless you explicitly ask for it to be published, and an edit to a live Riddle lands in its draft. Your embed only changes when the Riddle is published.

Your permissions apply

Everyone signs in with their own Riddle account. Project roles and AI permissions carry over one to one, and an agent can never reach a project its user cannot reach.

GDPR & CCPA compliant

Cookie- and tracker-free by default, WCAG 2.1 accessible, ISO 27001-certified, hosted on company-owned servers in Germany and Luxembourg by a German company. See our data privacy standards →

Stays editable

Everything the AI builds shows up in the Riddle Creator like any other Riddle. Open it, change a question by hand, restyle it, publish it. No lock-in, no separate AI silo.

Who builds Riddles from a chat

Publishers and newsrooms

Turn every article into engagement. A news quiz under the story, a poll on the day’s debate, a prediction game for match day, built in the same chat where the piece is written and embedded before it goes live.

How publishers use Riddle →

Marketing teams

Lead-gen quizzes and product recommenders in minutes instead of sprints, on brand, with double opt-in and your CRM connected. The form sits inside the content, which is why opt-in rates stay high and every contact arrives pre-qualified by its answers.

How teams generate leads →

HR and internal comms

Onboarding quizzes, employee surveys and team prediction games with leaderboards. Ask for one in your chat, publish it behind your own domain, keep every response in Europe.

Build a survey →

Agencies

Build for several clients from one chat. Projects, templates and brand palettes keep every account separate and on brand, and the agent works inside the permissions of whoever is signed in.

How agencies use Riddle →

Build, measure, optimize, in one conversation

Building is the easy half. Ask your AI how last week’s quizzes performed and it pulls views, starts and submissions per Riddle, per project and per day, plus the answer-level breakdown for every single question.

From there the loop closes: the drop-off question is found, a fix is proposed, the edit is applied as a merge and the Riddle is republished, without ever leaving the chat. That is the part a static API call cannot do for you.

More about audience insights →

Riddle analytics dashboard showing views, starts, completions and answer-level engagement

What our customers say

Riddle helps our Children’s interactive team to quickly create engaging content that provide compelling data insights about our audience.
Derek Harvie
Derek Harvie Executive Producer BBC
Riddle has become an essential tool for our marketing team. Their platform enables us to quickly and easily create engaging content that captures zero-party data, giving us a deeper understanding of our audience.
Steve Sarner
Steve Sarner VP Ad Sales and Program Management Amazon (Goodreads)

  • What is the Riddle MCP server?

    It is a remote MCP server that exposes the Riddle API to AI agents. Anything you can do through the API, such as listing, building, editing, publishing and analyzing Riddles, can be triggered from an AI chat. The server URL is https://www.riddle.com/creator/api/v3/mcp.

    Which AI apps does it work with?

    Any MCP client that supports remote servers, including Claude, Claude Code, Cursor and VS Code. The URL is the same everywhere, and Riddle is listed in the official MCP Registry as com.riddle/creator.

    Do I need a Riddle account?

    Yes. The MCP server works on your own Riddle account, and there is a 14-day free trial with every feature unlocked and no credit card required.

    Does anything go live automatically?

    No. A new Riddle is created as a draft unless you explicitly ask for it to be published, and an edit to a live Riddle lands in its draft. Publishing is always its own step, so your embed only changes when you say go.

    How does authentication work?

    Preferably by signing in: you add the public MCP URL as a connector and authorize with your own Riddle account. Alternatively you can create an MCP key in your account and append it to the URL as a path segment. Signing in is the better route, because no account has to be pre-configured in the URL.

    Which plan do I need?

    The MCP server is included in every Riddle plan. Only dry-run validation of build configurations requires Business or Enterprise.

    Can my whole team use it?

    Yes. Each person authorizes individually with their own account, and their project roles and AI permissions apply exactly as they do in the Creator. Organizations can add the connector centrally for everyone.

    Is it GDPR-compliant?

    Yes. Riddle is 100% GDPR- and CCPA-compliant, ISO 27001-certified and WCAG 2.1 accessible, sets no third-party tracking cookies, and hosts all data on company-owned servers in Germany and Luxembourg.

    What is the difference between the MCP server and the Riddle API?

    The same capabilities with a different interface: the REST API is for your code, the MCP server is for your AI. The MCP server adds the parts an agent needs on top, such as 67 reference documents it can read on demand and 12 guided workflows that chain the tools in the right order.

    Can I keep working in the Riddle Creator?

    Yes. Everything the AI builds appears in the Creator like any other Riddle and stays fully editable by hand, so you can hand a draft to a colleague who has never opened an AI chat.

GDPR, CCPA & ISO 27001

Riddle is 100% GDPR-compliant, ISO 27001-certified, WCAG 2.1 accessible, and hosted in Germany and Luxembourg, keeping your audience’s data safe when your AI builds for them.

Ready to build your first Riddle from a chat?

Start a 14-day free trial, add the connector, and describe what you need. Every feature unlocked, no credit card required.
MCP server URL https://www.riddle.com/creator/api/v3/mcp

MCP documentation Riddle REST API All integrations Support Listed in the official MCP Registry as com.riddle/creator