Connect Riddle to your AI tool (MCP)

Looking for an AI assistant that builds a Riddle for you? The support chat is answered by our team, not by an AI builder. To build with AI, use Create a Riddle with AI in the Creator, or connect your AI tool as described below.

Connect your Riddle account to your AI tool so it can create, analyze, and manage your Riddles from a plain-English prompt like "Build me a 5-question quiz on solar panels in German."

Riddle works with every AI tool that speaks MCP (Model Context Protocol): Claude, ChatGPT, Google Gemini and Grok. The setup takes about a minute in each of them: you add Riddle once, sign in with your Riddle account, and you're done. There is no API key to create, copy or share.

Claude and ChatGPT list Riddle in their directories, so there you just search for Riddle and click connect. For Gemini and Grok, the only thing you need to paste is:

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

This guide is the step-by-step setup. The MCP reference covers the OAuth flow, MCP keys for unattended setups, and the complete list of tools and resources.

Watch the full walkthrough

7:25 minutes, end to end: connecting your AI tool and then working with Riddle straight from the chat.

Good to know before you start:

  • Where it works: Setting up the connection works in the web (and desktop) versions of these tools. The official Riddle Creator plugin for ChatGPT also works on the free ChatGPT plan. Custom connectors (Gemini, Grok) may need a paid plan – check your AI provider's own plan details.
  • Riddle plans: The MCP works on every plan, including creating, publishing and managing Riddles and reading your stats.
  • AI credits: AI generation tools (e.g. "Make me a quiz about X") use your account's AI credits, just like generating Riddles in the Creator. Ask "How much AI usage do I have left?" anytime to check your quota.
  • Your account, your projects: You sign in with your own Riddle account, so your AI tool only reaches the projects your AI permissions allow.

Claude

Riddle is listed in Claude's connector directory, so there is no URL to type.

Shortcut: open the Riddle entry in Claude's directory and continue with step 3.

  1. In Claude, click Customize in the left sidebar and open the Connectors tab. Claude Customize page with the Connectors tab and the Discover view
  2. Switch to Discover and search for riddle. Click the Riddle connector.
  3. Click Connect. (Once you're set up, the button shows Connected, as in the screenshot.) Riddle connector page in the Claude directory
  4. Sign in to Riddle in the window that opens and confirm the access.

Done. In a new chat, click + below the message field, open Connectors and make sure Riddle MCP is switched on.

ChatGPT

Riddle has an official ChatGPT plugin: Riddle Creator. You install it from ChatGPT's plugin directory – no developer mode, no URL to type.

Shortcut: open Riddle Creator in the ChatGPT plugin directory and continue with step 3.

  1. In ChatGPT, click Plugins in the left sidebar (or go to chatgpt.com/plugins) and search for riddle. ChatGPT Plugins page with the Riddle Creator search result
  2. Click Riddle Creator by Riddle.
  3. Click Install plugin. Riddle Creator plugin page in ChatGPT with the Install plugin button
  4. Click Connect Riddle Creator. Connect Riddle Creator dialog in ChatGPT
  5. Sign in to Riddle in the window that opens and confirm the access. ChatGPT then shows Riddle Creator plugin installed. Riddle Creator installed in ChatGPT with the Try in chat button

Done. Click Try in chat to start right away, or, in any new chat, click + below the message field and pick Riddle Creator. ChatGPT plus menu with Riddle Creator

ChatGPT puts Riddle Creator in front of your prompt, so it knows to use Riddle:

ChatGPT message field with a Riddle Creator prompt

Riddle Creator builds the Riddle as a draft in your account and shows a preview right in the chat, with buttons to Publish, check the Mobile view or Open in Creator. Prompts to try:

  • "Create a 5-question quiz about the history of the Olympic Games and show me the preview."
  • "List my Riddles and tell me which ones had the most views this month."
  • "Build a personality test that recommends one of my three products and asks for the email address at the end."

Added Riddle to ChatGPT manually before? If you set up a custom plugin in developer mode (named Riddle MCP in our old guide), remove it under Plugins and install Riddle Creator instead, so you don't have Riddle twice.

Google Gemini

Riddle isn't in Gemini's app directory yet, so you add it as a custom app.

  1. In Gemini, click the Settings gear at the bottom left and choose Connected Apps. (You can also click Customize in the sidebar and open the Connectors tab.) Gemini settings menu with Connected Apps
  2. On the Connected Apps page, click + Custom next to the search field. Gemini Connected Apps page with the Custom button
  3. In Connect to an MCP server, paste https://www.riddle.com/creator/api/v3/mcp into MCP Server URL and click Next. Gemini Connect to an MCP server dialog with the Riddle URL
  4. Read the summary, tick I understand and accept the security and privacy risks of connecting this custom app and click Connect. Gemini Connect this MCP server confirmation
  5. Sign in to Riddle in the window that opens and confirm the access.

Done. Riddle now shows up under Installed on the Connected Apps page. In a chat, type @ in the message field to pick it.

Grok

  1. In Grok, click Plugins at the bottom of the left sidebar. Grok sidebar with the Plugins button
  2. On the Connectors tab, click New Connector in the top right. Grok connectors page with the New Connector button
  3. In the New Connector dialog, choose Custom – Add your own custom connector. Grok New Connector dialog with the Custom option
  4. Enter a Name (e.g. Riddle MCP) and the Server URL https://www.riddle.com/creator/api/v3/mcp, then click Add Connector. Grok Custom Connector form with name and server URL
  5. Sign in to Riddle in the window that opens and confirm the access.

Done. Riddle is now available as a connector in your Grok conversations.

The Riddle sign-in

The sign-in window is the same for every AI tool. If you aren't signed in to Riddle yet, sign in first. Then:

  1. Choose a project. Give your AI tool access to all your projects (via your personal project), or pick a single project.
  2. Confirm. The summary shows what your AI tool can do: read your project list and stats, and read, create and manage Riddles and their embed codes and tags.
  3. Full access (optional). By default, the connection can only change Riddles that were created via the MCP, the API or Riddle AI, plus the media it uploaded itself. Tick the full access option if your AI tool should also be able to edit Riddles you built by hand in the Creator, Question Banks, tags and all media, wherever your role allows it.

Then confirm, and the window takes you back to your AI tool.

Try it out

Open a new conversation and make sure the Riddle connector is enabled for that chat. Then ask:

"Show me my last Riddle."

If your AI tool returns one of your Riddles, you're set. (If not, see Troubleshooting below.)

Now try anything you'd normally do in Riddle:

  • "List my last 5 Riddles."
  • "Create a quiz about climate change with 7 questions in English."
  • "Show me the stats for my 'Brand awareness quiz' from the last 30 days."
  • "Publish the Riddle named 'Holiday giveaway 2026'."

Your AI tool picks the right action and carries it out in your account.

Get better results

Three habits that get you from prompt to finished Riddle with the least back and forth.

1. Say what you want upfront

Instead of "Make a quiz about marketing", try:

"Create a 5-question quiz on email marketing best practices, in English, single-choice answers, with a results page that shows a score."

The same trick works for rules that should apply to a whole conversation – state them once at the start: "For all Riddles in this chat: friendly tone, address the user with 'you', language German."

2. Pick the right kind of creation

Riddle can create content in two ways – and your phrasing decides which one is used:

  • "Build a quiz with these exact 5 questions: …" → the structured builder. Best when you already know your content.
  • "Make me a quiz about X" → Riddle's AI generation invents the questions. Best for fast, topic-based content.

Builder for precision, generation for speed.

3. Iterate, don't restart

If something's off, refine it: "Change question 3 to multiple-choice", "Translate the result page to French". Iterating on an existing Riddle is faster than deleting it and starting over.

Troubleshooting

The connection or sign-in failed Remove the Riddle connector in your AI tool and add it again. If you had to type the URL, check that it is exactly https://www.riddle.com/creator/api/v3/mcp, and make sure you're signed in to the Riddle account you want to use before you authorize.

"I don't have access to project X" The connection only works for projects where your user has the right AI permissions. Ask your project admin to grant access.

Your AI tool can't change a Riddle you built in the Creator By default, the connection only changes Riddles created via the MCP, the API or Riddle AI. Remove the Riddle connection in your AI tool, add it again and tick the full access option during the Riddle sign-in.

Your AI tool doesn't seem to use Riddle Most tools let you enable connectors per conversation. Open the connector or tools menu below the message field and make sure Riddle is switched on.

Your AI tool can't add custom connectors Custom MCP connectors are a paid feature in some AI tools, and in business workspaces an admin may have to allow them first. Check your AI provider's plan and workspace settings.

Want to disconnect? Remove the Riddle connector in your AI tool to revoke its access to your account.

Still stuck? Reach out to our support team via the support chat or via email.

Using another AI tool, or building your own integration?

Any MCP-compatible client works – Cursor, Cline, VS Code, custom agents – with the same server URL and the same sign-in. If you want the technical details (the OAuth flow, MCP keys for unattended or multi-account setups, and the complete tool and resource reference), see the technical MCP guide.

Next steps