{"data":{"name":"com.riddle/creator","title":"Riddle","description":"Build, publish and analyze quizzes, polls, forms and personality tests. Riddle account required.","version":"1.0.2","websiteUrl":"https://www.riddle.com/help/api/mcp","repositoryUrl":null,"remotes":[{"url":"https://www.riddle.com/creator/api/v3/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-08-20T13:04:12.494Z","updatedAt":"2026-08-20T13:04:12.494Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Riddle","source":"official-registry","sourceId":"com.riddle/creator","updatedAt":"2026-08-20T13:04:12.494Z","confidence":100,"websiteUrl":"https://www.riddle.com/help/api/mcp","description":"Build, publish and analyze quizzes, polls, forms and personality tests. Riddle account required.","verification":"official","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"integration_list","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Only this kind. Omit for both.","default":null,"enum":["googlesheets","webhook"]},"projectId":{"type":["null","integer"],"description":"The project (team) ID, as returned by project_list. Omit for the project the API key is scoped to.","default":null}},"additionalProperties":false},"annotations":{"title":"List integrations","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2e6ea9b60ba20836f19d2fa46434250d97c9288f1c4698d2a2169460fd5b10ff","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"media_delete","title":null,"description":"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://reference/concepts/access.","inputSchema":{"type":"object","properties":{"mediaId":{"type":"integer","description":"The media library id of the file to delete - the \"mediaId\" the upload response returned, or the id shown for the file in the Creator's media library."},"project":{"type":["null","integer"],"default":null,"description":"Project ID; NULL or omitted: your personal project (project API key: its project). A mediaId only resolves in its project - build in the same one."}},"required":["mediaId"],"additionalProperties":false},"annotations":{"title":"Delete media library file","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"88684d5a6e23d96603098f9d9859ac02496f4b4e276da069fa2450e842faa161","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"media_upload_link","title":null,"description":"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' '<uploadUrl>' (the link carries its own signature, so no API key or header). That POST leaves your environment and needs outbound HTTPS to the host in \"requiresNetworkAccessTo\" (allowlist the wildcard it gives; in Claude only an admin can change that organization setting). If it is blocked or does not resolve, tell the user which host to allow - do not retry or look for another way in. The POST answers with {mediaId, type, width, height, size, folderId, project}: \"mediaId\" is the ONLY handle - use it as \"media\": {\"type\": \"Image\", \"mediaId\": <mediaId>} in a block (riddle://reference/riddle-builder/block-types). Never guess a url for it: a CDN url passed as a plain \"url\" media is re-downloaded as a second, unrelated copy - the account pays twice and this file records no usage, which makes an image in a live Riddle look safe to delete. The file lands in the account's \"AI Uploads\" folder tagged \"AI Upload\", counts against their storage, and media_delete removes it again.","inputSchema":{"type":"object","properties":{"project":{"type":["null","integer"],"default":null,"description":"Project ID; NULL or omitted: your personal project (project API key: its project). A mediaId only resolves in its project - build in the same one."}},"additionalProperties":false},"annotations":{"title":"Create media upload link","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"4ad4fdd131b44753458e88d9a66f384b9f8796c2961595e7049ad7ecf3c5b8f2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"palette_customize","title":null,"description":"Changes the palette (colors, fonts, button styles, background) of ONE Riddle, as a path => value map, e.g. {\"bgColor\": \"#ffffff\", \"font.name\": \"Roboto\"} - the paths are palette_get's or riddle://reference/palette/fields. Never affects another Riddle: a palette inherited from the account/project default preset is not changed for the others, the values are stored as an override on this one. A built-in palette (\"default:*\") is stored nowhere and is therefore duplicated into a Riddle-owned copy automatically; newPaletteName always works on a copy. Two things to know. The new design only reaches the embedded (live) Riddle after another riddle_publish. A palette write does NOT move modifiedAt/modifiedBy (the Creator does not stamp them for a design change either), so polling those will not notice it: the detector is riddle_get's context.modified.hasChanges, true from the preset side. context.preset.drifted usually moves too but is not reliable alone - it means \"diverged from the PARENT preset\", so on a Riddle whose context.preset.parentId is null it stays false however much you change; read it only alongside parentId. Only if the Riddle's origin.writableByThisKey is true (riddle_get, riddle_list): riddle://reference/concepts/access.","inputSchema":{"type":"object","properties":{"riddleUUID":{"type":"string","description":"The UUID of the Riddle you want to restyle."},"values":{"type":"object","description":"Map of palette path => new value, e.g. {\"bgColor\": \"#ffffff\", \"buttonColor\": \"rgba(0,0,0,0.8)\", \"font.name\": \"Roboto\", \"riddleBorderRadius\": 12, \"isImageInBgDisplayed\": true}. Every path must be one of the paths listed in riddle://reference/palette/fields.","additionalProperties":true},"paletteUUID":{"type":["null","string"],"description":"The palette to change. Omit to change the currently selected palette. Pass a built-in id (\"default:timeless\") to start from that palette.","default":null},"newPaletteName":{"type":["null","string"],"description":"Create a new palette with this name (copied from paletteUUID / the selected palette) and apply the values to the copy, leaving the original untouched.","default":null},"select":{"type":["null","boolean"],"description":"Select the palette afterwards so the Riddle actually renders with it. Newly created palettes are always selected.","default":null}},"required":["riddleUUID","values"],"additionalProperties":false},"annotations":{"title":"Customize brand palette","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"0d99fae6f960b84e8aa1a84dd493d17e268bdd469375a2254cb126403ea4a8c8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"palette_get","title":null,"description":"Reads the palettes - colors, fonts, button styles, background settings - of a Riddle: every palette it can use (the ones inherited from the account/project default preset included) with all of their values, which one is selected, which values this Riddle overrides, and the built-in palettes to start from. What each value does is riddle://reference/palette/fields. Mind the size: ~30 values per palette and an account preset can contribute palettes that have nothing to do with this Riddle, so the full response runs into thousands of tokens. Cut it with \"omit\" - omit: [\"paletteValues\"] lists the palettes by uuid and name only, which is how you find WHICH one you want (paletteUUID then returns that one in full), and \"builtInPalettes\"/\"customizedValues\"/\"hints\" drop those keys. To read just the design in effect, pass the selectedPaletteUuid from such a listing as paletteUUID.","inputSchema":{"type":"object","properties":{"riddleUUID":{"type":"string","description":"The UUID of the Riddle whose palettes you want"},"paletteUUID":{"type":["null","string"],"description":"Return only this palette instead of all of them. Accepts a palette UUID or a built-in palette id like \"default:timeless\".","default":null},"includeBuiltInPalettes":{"type":["null","boolean"],"description":"Include the full values of all built-in palettes. Defaults to false, in which case only their ids and names are listed.","default":false},"omit":{"type":"array","description":"Leaves parts of the response out - the way to keep this call small. \"paletteValues\" lists every palette as {uuid, name} instead of with its ~30 values (then read the one you want with paletteUUID); \"builtInPalettes\", \"customizedValues\" and \"hints\" drop those keys entirely. Omit the parameter for the full response. Whatever you leave out is echoed back under \"omittedFields\", so a missing key never means the Riddle has none of it.","default":null,"items":{"type":"string","enum":["paletteValues","builtInPalettes","customizedValues","hints"]},"uniqueItems":true}},"required":["riddleUUID"],"additionalProperties":false},"annotations":{"title":"Get brand palette","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8263d921ac42a5860cf3b676ec88cf72bd75709cd8a151cb80289455c9c3aa55","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"ping","title":null,"description":"A simple tool that returns \"Pong\". Can be used to test connectivity and authentication to the MCP.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Ping the MCP server","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"32f068dcd775db6d59dcafc97d92148b999d13c65d0f4a6ce6caebaeeddb1315","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"project_get","title":null,"description":"Returns one project by id - id, name, image and the authenticated user's permission matrix for it. The id comes from project_list or from the \"team\" of riddle_get. The project's default Riddle settings are NOT included; they are a large nested tree with its own tool, project_get_settings.","inputSchema":{"type":"object","properties":{"projectId":{"type":"integer","description":"The ID of the project to look up"}},"required":["projectId"],"additionalProperties":false},"annotations":{"title":"Get project","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"246ead91d5b6252e3e08f3b97d3e477298d35e7090aee24bb3da8fcdf07ecb94","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"project_get_settings","title":null,"description":"Returns the default Riddle settings every new Riddle of the project starts from - PUBLISHED and ENABLED only: \"publishSettings\" (privacy/DOI/OTP, email automation, tracking, data layer, ...) and \"embedSettings\" (iframe sizing, auto-scroll, ...), each holding only the areas whose \"isDefaultEnabled\"/\"isEnabled\" was on in the last published version. Never-published drafts and disabled areas are deliberately left out - this is what applies to Riddles right now, not a way to inspect unpublished or disabled defaults. Internal \"_ids\" bookkeeping (counters for repeatable items) is stripped, meaning nothing outside the Creator. Both fields are always objects keyed by settings area - a project with nothing enabled gets {}, never an empty list. Read it to know what a project forces onto its Riddles before creating or editing one there; project_get is the cheap call for name, image and permissions.","inputSchema":{"type":"object","properties":{"projectId":{"type":"integer","description":"The ID of the project whose default Riddle settings to return"}},"required":["projectId"],"additionalProperties":false},"annotations":{"title":"Get project settings","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0d1e546fa73e95a49f47c362faaa444dc4af574765abc1a6c5364028dafedd29","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"project_list","title":null,"description":"Lists the projects this token has access to as {items, page, pageSize, total, hasMore} - the paging every listing of this server answers with (riddle://reference/concepts/response-envelope), here 25 per page, 100 max, so an account with many projects can be paged through; a project API token only ever returns its own project. Each entry is a trimmed summary (id, name, image): project_get adds your permissions on one, project_get_settings its default Riddle settings. An invalid page/pageSize (zero, negative, or over 100) is rejected rather than silently clamped.","inputSchema":{"type":"object","properties":{"page":{"type":["null","integer"],"description":"Page number to fetch (1-indexed). Defaults to 1. Zero, negative or non-numeric is rejected, not clamped.","default":null},"pageSize":{"type":["null","integer"],"description":"How many projects to return per page (max 100). Defaults to 25. Same validation as page; over 100 is rejected, not clamped.","default":null}},"additionalProperties":false},"annotations":{"title":"List projects","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3371c8bee71599211e60ea2eed934e9caba85a13beed7693108539bf0d7e10ab","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_create","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"riddleType":{"type":"string","description":"The Riddle type this bank's items are shaped for - \"Quiz\" or \"Poll\". Fixed for the lifetime of the bank; every item added later must match it."},"title":{"type":["null","string"],"description":"The bank's title. Defaults to \"New question bank\" when omitted.","default":null},"projectId":{"type":["null","integer"],"description":"The project (team) ID to create the bank in, as returned by project_list. Omit for the project the API key is scoped to (your personal space on a user API key).","default":null}},"required":["riddleType"],"additionalProperties":false},"annotations":{"title":"Create question bank","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"57c839fb6ed4c5c0b4d2309e051bfccece005d9dcade1ce64f91f11a4a38a7b6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_delete","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to delete."}},"required":["questionBankId"],"additionalProperties":false},"annotations":{"title":"Delete question bank","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"00097be7f4574722a4728030bd53d1beda6e88d7f648190f94760b25095cc1ff","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_discard_changes","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to discard the unpublished changes of."}},"required":["questionBankId"],"additionalProperties":false},"annotations":{"title":"Discard question bank changes","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"68ebd91bc98f47f66c3b97e0dbc95d162b97561fc03c31aad944186ee0cfe838","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_duplicate","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to copy - your own, or a template id from question_bank_list(scope: \"templates\")."},"title":{"type":"string","description":"The title of the copy."},"projectId":{"type":["null","integer"],"description":"The project (team) ID the copy should land in, as returned by project_list. Omit for the project the API key is scoped to.","default":null}},"required":["questionBankId","title"],"additionalProperties":false},"annotations":{"title":"Duplicate question bank","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"7eadd0ad7c1a251632c4499e859829e0704f31edfa3edaf64c822945b032aed6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_get","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to retrieve, as returned by question_bank_create/question_bank_list - or of a built-in template from question_bank_list(scope: \"templates\")."}},"required":["questionBankId"],"additionalProperties":false},"annotations":{"title":"Get question bank","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"03263f6e9bfeaca395fe1f425251c853442759749f313541252a673cbbbe10a4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_get_items","title":null,"description":"Lists the items of a question bank - its DRAFT content by default, or its published items with published: true. Filter by search term, blockType, category or difficultyRange - the same filters a QuestionBank block draws with. A template id from question_bank_list(scope: \"templates\") reads too - that is how to preview its questions before duplicating it. Paginated {items, page, pageSize, total, hasMore}. The item shape, the \"columns\" format, the pagination it runs with and what the response leaves out: riddle://reference/concepts/question-bank-items.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The bank to list items of - your own, or a template id from question_bank_list(scope: \"templates\")."},"search":{"type":["null","string"],"description":"Filter items by their column values (e.g. a question title or a choice).","default":null},"blockType":{"type":["null","string"],"description":"Filter to one block type (e.g. \"SingleChoice\").","default":null},"category":{"type":["null","string"],"description":"Filter to one category.","default":null},"difficultyRange":{"type":["array","null"],"description":"Filter to a difficulty range, as [min, max] (e.g. [1, 5]).","default":null},"published":{"type":["null","boolean"],"description":"Read the bank's PUBLISHED items instead of its draft (default false) - a different set of items, and the pool a live Riddle's QuestionBank block actually draws from. Counting what one block criterion can draw is then a single call: its blockType/category/difficultyRange plus pageSize: 1, then read \"total\" - what that number does and does not include is in riddle://reference/concepts/question-bank-items.","default":null},"page":{"type":["null","integer"],"description":"Page number, starting at 1 (default: 1).","default":null},"pageSize":{"type":["null","integer"],"description":"Items per page (default: 250, max: 500).","default":null}},"required":["questionBankId"],"additionalProperties":false},"annotations":{"title":"Get question bank items","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"59d0a8837090e3d445c309594a18d6d3996b5e8476048997801f7c1787f24fb2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_item_add","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to add the item to."},"blockType":{"type":"string","description":"The block type this question is shaped for, e.g. \"SingleChoice\". riddle://reference/question-bank/block-type-columns lists the ones valid for this bank's riddleType."},"category":{"type":"string","description":"The item's category - free text, used to filter what a QuestionBank block draws (see the \"questionBankCriteria\" of the QuestionBank block type)."},"difficulty":{"type":"integer","description":"The item's difficulty, 1-10 - also used to filter what a QuestionBank block draws."},"columns":{"type":"object","description":"The question content, as {columnName: [values]} - never a list, and a column holding a single value still takes a list. Which names are valid depends on the bank's riddleType AND the blockType, so take them from riddle://reference/question-bank/block-type-columns instead of guessing (an unknown one is rejected, naming it and the valid ones).","additionalProperties":{"type":"array","description":"The values of this column, in order - either plain strings/numbers, or the {\"id\": .., \"value\": ..} objects question_bank_get_items returns. Position in this array is what defines the order; the \"id\"s carry no order of their own.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","properties":{"id":{"type":["integer","null"],"description":"The value's ID as returned by question_bank_get_items for this item; omit or null to have one assigned, and an ID the item does not have is rejected. It is an opaque handle for addressing THIS value on an update and nothing else - never sort or index by it (riddle://reference/concepts/question-bank-items). A column's order is the order of this array alone."},"value":{"type":["string","number"]}},"required":["value"],"additionalProperties":false}]}}}},"required":["questionBankId","blockType","category","difficulty","columns"],"additionalProperties":false},"annotations":{"title":"Add question bank item","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"1be1c0d23823d56dc6e9cd353147475931dec3b83f27aff7f45675db9d664c3f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_item_delete","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank the item belongs to."},"questionBankItemId":{"type":"integer","description":"The ID of the item to delete, as returned by question_bank_get_items or question_bank_item_add."}},"required":["questionBankId","questionBankItemId"],"additionalProperties":false},"annotations":{"title":"Delete question bank item","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"1e5cadd1a23b0eb657acf3e8001402c1361c80d0dc4a6ec5746aa86b8bc20129","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_item_update","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank the item belongs to."},"questionBankItemId":{"type":"integer","description":"The ID of the item to update, as returned by question_bank_item_add/question_bank_get_items."},"blockType":{"type":"string","description":"The item's current block type, sent back unchanged (question_bank_get_items returns it). Immutable: a different value is rejected."},"category":{"type":"string","description":"The item's category - free text, used to filter what a QuestionBank block draws."},"difficulty":{"type":"integer","description":"The item's difficulty, 1-10 - also used to filter what a QuestionBank block draws."},"columns":{"type":"object","description":"The question content, as {columnName: [values]}. This replaces the content entirely rather than merging: send every column, and hand question_bank_get_items output straight back with its {\"id\", \"value\"} objects intact - keeping those ids is what edits the stored values instead of replacing them with a fresh set.","additionalProperties":{"type":"array","description":"The values of this column, in order - either plain strings/numbers, or the {\"id\": .., \"value\": ..} objects question_bank_get_items returns. Position in this array is what defines the order; the \"id\"s carry no order of their own.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","properties":{"id":{"type":["integer","null"],"description":"The value's ID as returned by question_bank_get_items for this item; omit or null to have one assigned, and an ID the item does not have is rejected. It is an opaque handle for addressing THIS value on an update and nothing else - never sort or index by it (riddle://reference/concepts/question-bank-items). A column's order is the order of this array alone."},"value":{"type":["string","number"]}},"required":["value"],"additionalProperties":false}]}}}},"required":["questionBankId","questionBankItemId","blockType","category","difficulty","columns"],"additionalProperties":false},"annotations":{"title":"Update question bank item","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"89e7ee0910cd2a37f5d943d35b50d2cdd8af2837300bfc201849b176bed99dc9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_list","title":null,"description":"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_get_items before duplicating. Every write here rejects a template id: a template is only ever changed through a copy of it.","inputSchema":{"type":"object","properties":{"scope":{"type":"string","description":"What to list: \"own\" (default) for the question banks of a project, \"templates\" for the built-in starter banks anyone can duplicate.","default":null,"enum":["own","templates"]},"riddleType":{"type":["null","string"],"description":"Filter by Riddle type (\"Quiz\" or \"Poll\"). Omit to list banks of every type. Applies to both scopes.","default":null},"tags":{"type":["array","null"],"description":"Filter by tag IDs (array of integers), as returned by riddle_tag_list. Omit to ignore tags. Scope \"own\" only.","default":null},"search":{"type":["null","string"],"description":"Search term to filter banks by title. Scope \"own\" only.","default":null},"sortBy":{"type":["null","string"],"description":"Sort field: \"createdAt\" or \"modifiedAt\". Defaults to \"createdAt\". Scope \"own\" only.","default":null},"sortOrder":{"type":["null","string"],"description":"Sort direction: \"ASC\" or \"DESC\". Defaults to \"DESC\". Scope \"own\" only.","default":null},"page":{"type":["null","integer"],"description":"Page number (default: 1). Scope \"own\" only.","default":null},"pageSize":{"type":["null","integer"],"description":"Items per page (default: 12, max: 50). Scope \"own\" only.","default":null},"projectId":{"type":["null","integer"],"description":"The project (team) ID whose banks you want, as returned by project_list. Omit for the banks of the project the API key is scoped to (your personal ones on a user API key). Scope \"own\" only.","default":null}},"additionalProperties":false},"annotations":{"title":"List question banks","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c79da198e5de9e1676804fbf1d93d8b22505c26786d8161240444a4fa39869a0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_publish","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to publish."}},"required":["questionBankId"],"additionalProperties":false},"annotations":{"title":"Publish question bank","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"354ad10ea4581b7181c19c5521ebc0648ca1d7a96de098922aec6a2cf408888e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_rename","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to rename."},"title":{"type":"string","description":"The new title."}},"required":["questionBankId","title"],"additionalProperties":false},"annotations":{"title":"Rename question bank","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"44e896164eec42767cb17c72b37e2b45140eb490d74fff2e170d1cba5af6c2f6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_tag_add","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to tag."},"tagName":{"type":["null","string"],"description":"The name of the tag. The project's tag of that name is reused, or created if there is none yet. Pass either this or tagId.","default":null},"tagId":{"type":["null","integer"],"description":"The ID of an existing tag, as returned by riddle_tag_list. Pass either this or tagName.","default":null}},"required":["questionBankId"],"oneOf":[{"required":["tagName"],"properties":{"tagName":{"not":{"type":"null"}},"tagId":{"const":null}}},{"required":["tagId"],"properties":{"tagId":{"not":{"type":"null"}},"tagName":{"const":null}}}],"additionalProperties":false},"annotations":{"title":"Add tag to question bank","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ca1e18ab8752886e4415ced9a4c8630dc2a4caf7b9483fb66c99c0b1f1bb731d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_tag_remove","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to untag."},"tagName":{"type":["null","string"],"description":"The name of the tag. Nothing is ever created; a name the bank does not carry is an error. Pass either this or tagId.","default":null},"tagId":{"type":["null","integer"],"description":"The ID of an existing tag, as returned by riddle_tag_list. Pass either this or tagName.","default":null}},"required":["questionBankId"],"oneOf":[{"required":["tagName"],"properties":{"tagName":{"not":{"type":"null"}},"tagId":{"const":null}}},{"required":["tagId"],"properties":{"tagId":{"not":{"type":"null"}},"tagName":{"const":null}}}],"additionalProperties":false},"annotations":{"title":"Remove tag from question bank","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"e1315729f16c1c3b3cc440e4c0a46487f8e3561133f1a010bdef75f248015417","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"question_bank_update_notes","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"questionBankId":{"type":"integer","description":"The ID of the question bank to annotate."},"notes":{"type":"string","description":"Plain-text notes for this bank, e.g. sourcing/curation instructions - replaces any existing notes entirely."}},"required":["questionBankId","notes"],"additionalProperties":false},"annotations":{"title":"Update question bank notes","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"3dd225e8479de1b0742e413d92e9c0aa01b3a2d894042e896d0d3a396cbe84ac","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"},{"serverName":"com.riddle/creator","endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","name":"reference_get","title":null,"description":"Read this server's own documentation: the block types, form field types, result blocks, palette values and response shapes the other tools expect. Every \"riddle://reference/...\" URI named in a tool description, a response or an error message is a topic of this tool - pass it here to read that document. These are the authoritative parameter reference for the riddle_builder_* and palette_* tools: read the relevant one BEFORE the first call instead of guessing property names, and re-read it when a call fails with a VALIDATION_ERROR. Up to 3 topics per call, and only the ones you need - most are long. Which topics exist, and what each one holds, is the \"topics\" parameter's own enum and description - not repeated here.\n\n\"riddleType\", \"blockTypes\" and \"fieldTypes\" narrow a document to your own material, and are ignored - whole document returned, stated in the response - on one that has no such split. block-types is never returned unscoped: {\"riddleType\": [\"Quiz\"]} is still all thirteen of a Quiz's block types (~20 KB), so name the ones you are about to build in \"blockTypes\" (a Quiz filtered to [\"SingleChoice\"]: ~5.5 KB, and it says everything about that block the wide read does). Decide the blocks first, then read only those. \"fieldTypes\" does the same for form-field-types and form-field-defaults, so reading both of them with {\"fieldTypes\": [\"Dropdown\"]} is the complete reference for one field type and nothing else. The per-entity families need no filter at all - riddle://reference/block-defaults/SingleChoice IS the filtered read.","inputSchema":{"type":"object","properties":{"topics":{"type":"array","description":"The documents to read, as their \"riddle://reference/...\" URIs (a document's short resource name, e.g. \"block-types\", works too). What each one holds:\n- riddle://reference/index: every document this server has, with its exact size. Read this first when you do not know which of the others you need - it is by far the smallest, and the one place the member names of the {...} families below are listed.\n- riddle://reference/getting-started: what this server is for, the authentication model, the guided prompts, and the addresses of the documents that hold the rules. Start here when unsure which tool to use.\n- riddle://reference/prompts/{prompt} (one per guided prompt, e.g. riddle://reference/prompts/build_LeadGenQuiz): the playbook for a whole goal - what to ask the user first, the tool calls in order, what to verify, the traps. Read one when the user states a GOAL rather than an operation.\n- riddle://reference/response-format: the envelope every Riddle-returning tool answers with, plus the list, bulk and error shapes.\n- riddle://reference/riddle-builder/riddle-types: all 9 Riddle types with their required/optional build fields and result structure.\n- riddle://reference/riddle-builder/block-types: every question and content block type - the reference for the \"blocks\" of a riddle_builder_* call. Returned scoped only, and worth scoping twice (see \"blockTypes\").\n- riddle://reference/riddle-builder/form-field-types and .../result-blocks: the 19 form field types of the FormBuilder block, and the 12 result page block types with their format and styling options.\n- riddle://reference/concepts/{concept} (one per subject, e.g. riddle://reference/concepts/merge-semantics): how an edit merges, the \"preset\" and \"publish\" objects, branching logic, defaults, bulk calls, move restrictions, limits, troubleshooting.\n- riddle://reference/block-defaults/{blockType}, riddle://reference/riddle-defaults/{riddleType}, riddle://reference/form-field-defaults, riddle://reference/publish-defaults: what a read-back leaves out for still being at its default, and what that default is. Read riddle://reference/concepts/defaults once for how to use them.\n- riddle://reference/palette/fields, .../built-in-palettes, .../fonts: every palette value palette_customize accepts and where it shows up, the built-in palettes to start from, the available font families.\n- riddle://reference/question-bank/overview: what a question bank is, its draft/publish model, and how its items relate to a QuestionBank block - read before the first question_bank_create.","items":{"anyOf":[{"type":"string","enum":["riddle://reference/index","riddle://reference/getting-started","riddle://reference/response-format","riddle://reference/riddle-builder/riddle-types","riddle://reference/riddle-builder/block-types","riddle://reference/riddle-builder/form-field-types","riddle://reference/riddle-builder/result-blocks","riddle://reference/palette/fields","riddle://reference/palette/built-in-palettes","riddle://reference/palette/fonts","riddle://reference/publish-defaults","riddle://reference/form-field-defaults","riddle://reference/question-bank/overview","riddle://reference/question-bank/block-type-columns"]},{"type":"string","pattern":"^riddle://reference/(block-defaults|riddle-defaults|concepts|prompts)/[^/]+$"},{"type":"string","pattern":"^[a-zA-Z0-9][a-zA-Z0-9-]*$"}]},"minItems":1,"maxItems":3,"uniqueItems":true},"riddleType":{"type":"array","default":null,"description":"Narrow riddle-types/block-types to these Riddle type(s) - on block-types that drops every other type's question blocks while keeping the shared conventions (commonBlockProperties, the general Content/Ad/Quote blocks). REQUIRED on block-types unless \"blockTypes\" is given instead, and only the WIDE scope of it. Ignored on a topic with no per-type split, and not applicable to the block-defaults/riddle-defaults families - read the entity's own address there. Omit for every type.","items":{"type":"string","enum":["Quiz","Poll","Personality","Form","Predictor","Minigame","Leaderboard","Story","Placeholder"]},"uniqueItems":true},"blockTypes":{"type":"array","default":null,"description":"The block type name(s) you are actually going to build (e.g. \"SingleChoice\", \"WheelSpinner\"), narrowing block-types on top of whatever \"riddleType\" kept - the normal way to read that document, not an optimization for later: pass the two or three the Riddle needs, and come back for another. The names are deliberately not enumerated here (dozens of them, on a schema every agent reads every turn); an unknown one, or a real one outside the Riddle type(s) you filtered to, is rejected with the names that are valid for your situation. Omit for every block type.","items":{"type":"string"},"uniqueItems":true},"fieldTypes":{"type":"array","default":null,"description":"Narrow form-field-types and form-field-defaults to these form field type name(s) (e.g. \"Dropdown\", \"Privacy\"); the property sets a kept type refers to (propertySets/commonProperties) and the \"fields\" usage notes always come with it. Not enumerated here for the same reason \"blockTypes\" is not - an unknown one is rejected with the full list. Ignored on every other topic. Omit for every field type.","items":{"type":"string"},"uniqueItems":true},"includeAvailableTopics":{"type":"boolean","default":null,"description":"Whether to carry the full \"availableTopics\" catalogue. Omit it - the first reference_get of a session gets it, later ones get a pointer instead of repeating ~2.5 KB you already have. true gets it again (a fresh conversation on an existing session), false never pays for it."}},"required":["topics"],"additionalProperties":false},"annotations":{"title":"Get builder reference document","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c8a92fdb0b762d126ddfeb9b11134ed834775036c76fd82851a33d8026aa067f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T20:47:43.737Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"a81d9648393072159e90f19e0ece6816a181a08e0a29f39fe50fcf3bbb6e07df","protocol":"streamable-http","status":"indexed","toolCount":48,"observedAt":"2026-11-16T20:47:43.737Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.riddle/creator":{"url":"https://www.riddle.com/creator/api/v3/mcp"}}},"Cursor":{"mcpServers":{"com.riddle/creator":{"url":"https://www.riddle.com/creator/api/v3/mcp"}}},"VS Code":{"servers":{"com.riddle/creator":{"type":"http","url":"https://www.riddle.com/creator/api/v3/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://www.riddle.com/creator/api/v3/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.riddle%2Fcreator","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.riddle%2Fcreator","name":"com.riddle/creator","description":"Build, publish and analyze quizzes, polls, forms and personality tests. Riddle account required.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://www.riddle.com/creator/api/v3/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://www.riddle.com/help/api/mcp","repositoryUrl":null,"version":"1.0.2"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.riddle/creator","status":"online","lastCheckedAt":"2026-11-20T07:18:16.898Z","lastSuccessfulCheck":"2026-11-20T07:18:16.898Z","latencyMs":350,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:18:16.898Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:18:16.898Z"},"security":null,"timestamps":{"createdAt":"2026-08-20T13:04:12.494Z","updatedAt":"2026-08-20T13:04:12.494Z","observedAt":"2026-11-20T07:18:16.898Z"},"compatibility":{"serverVersion":"1.0.2","protocolVersions":[{"protocol":"mcp","version":null}]}}}}