Integration · Marketing

Connect Claude & ChatGPT to Riddle

Ask your AI to make a quiz about a topic or a web page, and Riddle AI builds it in your account. The AI can edit a quiz's questions and results, publish or unpublish it, and get the embed code or a QR code. On Business and Enterprise plans it can also read the leads a Riddle has collected and its statistics.

Connect Riddle Quiz Maker free

Free plan, no credit card. Takes about a minute.

Try asking

“Make a 10-question quiz about coffee, medium difficulty, in Danish.”
Riddle AI creates the quiz in the background, and the AI checks the status until it is ready.
“Turn this blog post into a quiz.”
It has Riddle AI create a quiz from the content of the page URL.
“Change question 3 and publish the update.”
It reads the quiz build, edits the question and saves it with publish switched on.

What your AI can do

Create with Riddle AI

Have Riddle AI create quizzes, polls and personality quizzes from a topic or a web page, and keep an eye on your AI allowance.

Build, publish and share

Create a Riddle from a full definition, edit its questions and results, publish or unpublish it, and get the embed code or QR code.

Leads and stats

Read the leads a Riddle collected, leaderboard entries and statistics per Riddle, project or account.

“Give me the embed code for the product finder.”
It finds the Riddle and returns the embed code for your website.
“How many leads did the giveaway quiz collect?”
It gets the contact details people entered in the Riddle. This needs a Business or Enterprise plan.
“Who is at the top of the leaderboard?”
It lists the Riddle's leaderboard entries.

65 tools for Riddle Quiz Maker

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

build_riddleChanges dataCreate a Riddle from a full definition: `type` and `build` with `title`, `blocks` (questions) and `result` pages.
create_batchVisible to othersCreate a new batch. Has effects visible outside this system. API summary: Creates a batch of Riddles using the Riddle Builder. The creation happens asynchronously.
create_bulkVisible to othersCreate a new bulk. Has effects visible outside this system. API summary: Creates a Quiz from multiple URLs via the Riddle AI.
create_fetchChanges dataCreate a new fetch. API summary: Performs a basic fetch for a single entity. (available for Business / Enterprise).
create_overview_fetchChanges dataCreate a new overview fetch. API summary: Performs an overview fetch for a single entity. (available for Business / Enterprise).
create_personality_quizChanges dataHave Riddle AI create a personality quiz about a `topic`: optional `num_questions`, `num_personalities`, `language`, `project` and `publish`. Runs in the background.
create_poll_from_topicChanges dataHave Riddle AI create a poll about a `topic`: optional `num_questions`, `language`, `project` and `publish`. Runs in the background; check it with get_generation_status.
create_poll_postChanges dataCreate a new poll. API summary: Creates a Poll from a URL via the Riddle AI.
create_projectChanges dataCreate a new project. Search projects first to avoid duplicates. API summary: Gets a list of the Riddles from a project (formerly: team) or user.
create_question_bankChanges dataCreate a new question bank. API summary: Creates a new question bank.
create_question_bank_discard_changeChanges dataCreate a new discard change for a question bank. API summary: Discards all changes from a question bank; meaning it will reset all items back to their published state.
create_question_bank_productChanges dataCreate a new product for a question bank. Search products first to avoid duplicates. API summary: Adds an item to a question bank.
create_question_bank_tagChanges dataCreate a new tag for a question bank. API summary: Adds a tag to a question bank.
create_quiz_from_topicChanges dataHave Riddle AI create a quiz about a `topic`: optional `num_questions`, `difficulty` (easy, medium, hard), `language`, `project` and `publish`. Runs in the background; check it with get_generation_status.
create_quiz_from_urlChanges dataHave Riddle AI create a quiz from the content of a web page `url`: optional `num_questions`, `difficulty`, `language`, `project` and `publish`. Runs in the background; check it with get_generation_status.
delete_question_bankDeletesPermanently delete a question bank by question bank. Destructive action; may require approval. API summary: Deletes a question bank and all its items.
delete_question_bank_productDeletesPermanently delete a product by question bank item. Destructive action; may require approval. API summary: Deletes an item from a question bank.
delete_question_bank_tagDeletesPermanently delete a tag by tag id. Destructive action; may require approval. API summary: Removes a tag from a question bank.
delete_riddleDeletesPermanently delete a Riddle by `riddle_uuid`, including its results. Set `dry_run` true to preview. This cannot be undone.
delete_riddle_deleteDeletesPermanently delete a riddle by tag. Destructive action; may require approval. API summary: Removes a specific tag from a Riddle.
get_a_list_of_1_0_riddlesList projects. Optional filters: type, user id created, tag ids or team id. Results are paginated. API summary: Get a list of 1.0 riddles.
get_account_statsChanges dataGet statistics across your own Riddles, optionally between `date_from` and `date_to`. Business and Enterprise plans only.
get_ai_usageShow how much of your Riddle AI allowance you have used.
get_block_type_columnGet one block type column by riddle type. API summary: Returns all Riddle + block type combinations for the question bank grid for one Riddle type.
get_embed_codeGet the website embed code for a Riddle by its UUID (`embed_code_uuid`).
get_generation_statusCheck the status of a Riddle AI generation by `status_uuid` (the UUID returned when you asked AI to create a Riddle).
get_looker_studio_linkGet one looker studio link by looker studio link uuid. API summary: Returns a Looker Studio Linking API URL that creates a report for the given Riddle with one click:.
get_presetGet one preset by project id. API summary: Gets all preset + palette IDs & names.
get_preset_settings_by_a_riddle_uuidGet one preset by preset uuid. API summary: Get preset settings by a Riddle UUID.
get_productGet one product by block id. API summary: Returns all question bank items which match the given filters for a given Riddle block.
get_projectGet one project by `project_id`.
get_project_getGet one project by project uuid. API summary: Gets all the tags from a Riddle.
get_project_statsChanges dataGet statistics for all Riddles in a project by `project_id`, optionally between `date_from` and `date_to`. Business and Enterprise plans only.
get_qr_codeGet the QR code that opens a Riddle, by its UUID (`qr_code_uuid`).
get_question_bankGet one question bank by question bank. API summary: Retrieves a specific question bank.
get_riddleGet one Riddle by `riddle_uuid`, with its type, title, status and settings.
get_riddle_buildGet the build definition (title, question blocks, results) of a Riddle by `riddle_builder_uuid`, to edit it.
get_riddle_statsChanges dataGet statistics for one Riddle by its UUID (`breakdown_uuid`), optionally between `date_from` and `date_to`. Business and Enterprise plans only.
get_riddle_v1Get one riddle v1 by riddle id. API summary: Gets info about a single 1.0 riddle.
list_defaultsList defaults. API summary: Get a list of all the default palettes.
list_embed_codesList embed codes. Optional filters: riddle id. API summary: Get the embed code for a given 1.0 riddle.
list_font_familiesList font families. API summary: Gets all font families.
list_lead_fieldsList lead fields. API summary: Get all the lead fields for a 1.0 riddle.
list_leaderboard_entriesChanges dataList the leaderboard entries of a Riddle by its UUID (`page_uuid`), with optional `search` and paging.
list_open_apisList open apis. API summary: This route returns the OpenAPI specification for the Creator API.
list_projectsList the projects (teams) you belong to. Use to find a project ID.
list_projects_2List projects. Optional filters: project. API summary: Get all tags & their occurrence counts from a user/team.
list_projects_getList projects. Optional filters: project. API summary: Returns a list of all tags + their usage count in the current (personal) project.
list_riddle_leadsChanges dataGet the leads (contact details people entered) collected by a Riddle, by `riddle_uuid`. Business and Enterprise plans only.
list_riddlesChanges dataList all quizzes, polls and other Riddles in your account, filtered by `search`, `status`, `type` or `tags`, with sorting and paging.
list_template_listsList template lists. Optional filters: riddle type. API summary: Lists all question bank templates.
list_typesList types. API summary: Get all riddle 1.0 types. Structure e.g. [[type = quiz, name = Quiz], ...].
publish_riddleVisible to othersPublish a Riddle by its UUID (`publish_uuid`), making it live for visitors.
search_projectsSearch projects by riddle type, sort by, sort order, tags, search or project. Use this to find existing projects before creating a new project. Results are paginated. API summary: Lists all question banks of the user or team.
search_question_bank_productsSearch products for a question bank by search, block type, category, difficulty or only published. Use this to find existing products before creating a new product. Results are paginated. API summary: Returns all items of a question bank.
submit_question_bankVisible to othersDuplicate a question bank (question bank). Has effects visible outside this system. API summary: Duplicates a question bank and all its items.
submit_question_bank_publishVisible to othersPublish a question bank (question bank). Has effects visible outside this system. API summary: Publishes a question bank and all its items.
submit_riddle_builderVisible to othersValidate a riddle builder. Has effects visible outside this system. API summary: Dry-runs one or many build configs without creating or changing anything.
unpublish_riddleChanges dataUnpublish a Riddle by its UUID (`unpublish_uuid`), taking it offline for visitors.
update_question_bank_messagesVisible to othersUpdate an existing message identified by question bank. Has effects visible outside this system. API summary: Updates the notes of a question bank.
update_question_bank_productChanges dataUpdate an existing product identified by question bank item. API summary: Updates an existing item of a question bank.
update_question_bank_renamesVisible to othersUpdate an existing rename identified by question bank. Has effects visible outside this system. API summary: Renames a question bank.
update_renameChanges dataUpdate an existing rename identified by rename uuid. API summary: Renames a Riddle with the specified UUID.
update_riddle_buildChanges dataEdit a Riddle by `riddle_builder_uuid`: pass the changed `build` (title, blocks, block order); set `publish` true to publish the changes.
update_riddle_postChanges dataUpdate an existing riddle identified by riddle uuid. API summary: Adds a tag to a riddle.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Riddle Quiz Maker from the app list.
2
Paste your key
Paste your Riddle API key. In the Riddle Creator, open the API keys page in your account settings, then create or copy an API key. Stats, leads and the Builder API need a Business or Enterprise Riddle plan.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Riddle?

It can list and read your Riddles and projects, have Riddle AI create quizzes, polls and personality quizzes, and build or edit a Riddle's questions and results. It can publish and unpublish Riddles, get embed codes and QR codes, read leads, leaderboards and statistics, and check your AI usage. It can also delete a Riddle if you switch that tool on.

Does the AI see my Riddle credentials?

No. Your Riddle credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with listing Riddles and reading stats. Publishing makes a Riddle live for visitors, and deleting one removes it with its results and cannot be undone. Both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Riddle account.

Which Riddle plan do I need?

According to Riddle, stats, leads and the Builder API need a Business or Enterprise plan. The AI uses your own API key, so what it can reach depends on your Riddle plan.