AI agents

Claude, or any AI agent that speaks the Model Context Protocol (MCP), can work with your quizzes: list, read, validate, create, copy, edit and publish the ones you own. For example:

• "Write me a ten-question quiz on the Q3 launch and put it in my frogQuiz."
• "In that quiz, make question 3 harder, drop the last one and add two about pricing."

The agent signs in with a personal key that you make on My Account. If My Account has no AI agents section, this frogQuiz has agents turned off.

Connecting an agent

1. Go to My Account, then AI agents. Name a key, for example "Claude on my laptop", and press Create key.
2. Copy the key straight away. It is shown once: frogQuiz keeps only a fingerprint of it, so it cannot show it again.
3. Add frogQuiz to your agent. The address to use is in the command My Account shows once, when you create the key.

Claude Code

My Account gives you this command ready to paste, with the address and key filled in:

claude mcp add --scope user --transport http frogquiz <address> \
  --header "Authorization: Bearer fq_…"

--scope user makes frogQuiz available in every folder, not only the one you ran the command in.

ChatGPT

A private ChatGPT plugin candidate is being developed for the existing https://api.frogquiz.xyz/mcp server. It will use the same account-scoped tools as Claude Code, without a separate local executable.

Not ready to install. The package declares personal API-key authentication, but support for entering that key in ChatGPT has not been verified. Do not paste an AI agent key into ChatGPT messages or embed it in a downloaded package. A supported credential setup or an account-based OAuth connection must be validated first.

When a supported connection is available, use a dedicated key from My Account, then ask ChatGPT to "List my quizzes, including their last changed dates." Test reading one of your own quizzes before creating or editing content. Publishing and deletion should require your explicit confirmation.

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "frogquiz": {
      "url": "<address>",
      "headers": { "Authorization": "Bearer fq_…" }
    }
  }
}

Claude Desktop

Claude Desktop connects to local servers only, so it goes through mcp-remote, which needs Node. In claude_desktop_config.json:

{
  "mcpServers": {
    "frogquiz": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<address>", "--header", "Authorization:${FROGQUIZ_AUTH}"],
      "env": { "FROGQUIZ_AUTH": "Bearer fq_…" }
    }
  }
}

The key sits in env because Claude Desktop on Windows splits arguments at spaces.

Check your connection

After connecting, ask: "List my quizzes, including their last changed dates." The agent should use your account's MCP tools and return only quizzes you own. If it cannot connect, verify the key, server address and client support before trying an edit.

What an agent can do

• List your quizzes, most recently changed first.
• Read one of your quizzes, with every question and its right answers.
• Make a quiz. Up to 50 questions, of any type the editor has: Multiple choice, Check choice, Poll, Type answer, Put in order, Slider, Info slide, Word cloud and Ranking. Each question gets 5 to 999 seconds (20 unless the agent says otherwise), and has to be finished: an agent never leaves you a draft. You can validate questions without saving.
• Edit one of your quizzes, including Public ones: change the title and description, reword questions, add, remove and reorder them.
• Copy a quiz you own, keeping its questions and images.
• Change visibility to Private, Link only or Public. Public quizzes appear in Discover.
• Upload images as PNG, JPEG, GIF or WebP bytes to a quiz you own. The server never fetches arbitrary image URLs.
• Preview Excel workbooks without saving, or export your own quiz to a workbook.
• Delete and recover quizzes: confirm deletion with a single-use token. The agent can list your recoverable trash and restore a quiz within 30 days. After that, the worker permanently purges it and releases its images.

When a create or copy times out

The MCP server retries internally, but each new create_quiz or copy_quiz tool call has its own idempotency key. Your agent should check list_my_quizzes before making another call. If it cannot determine whether the first call succeeded, it should ask you before risking a duplicate.

How editing works

• Questions the agent does not change stay exactly as they were, with their formatting, their image and their question type.
• A question the agent rewords keeps its image, its timer and its type unless you ask for another, but its text becomes plain: bold or italic on that question is lost.
• A question the agent removes is gone, and so is its image.
• If you have the quiz open in the editor while an agent edits it, the editor tells you the quiz was changed in another tab rather than saving over the agent's edit. The agent is stopped the same way if you saved after it read the quiz, and reads it again.
• A game already running keeps the version it started with.

Private quizzes: your key is you, so an agent can list, read and edit your Private quizzes, and never anyone else's. Only a separate visibility action changes who can view a quiz.

Safety and boundaries

• Publishing is deliberate. Changing visibility to Public exposes a quiz in Discover. Have the agent ask before doing so.
• Only your quizzes. Another person's quiz cannot be read, modified, copied or deleted, even if it is Public.
• Agent deletion is reversible for 30 days. You must confirm a delete request within five minutes. Recovery uses the agent tool, not a Trash screen. The regular Delete action in My Quizzes is still permanent.
• Images are uploaded as files, never fetched from arbitrary URLs. File formats, dimensions, storage quotas and ownership are enforced server-side. Hiding a question's results remains a setting in the editor.
• Keys do not sign in to the website or host a game. Store your key securely and revoke it in My Account if it is exposed.
• Claude's hosted custom connectors still require OAuth. frogQuiz currently uses personal keys and can be connected from supported MCP clients.

How much

• 120 agent requests a minute.
• 30 new quizzes an hour, 200 a day.
• 60 edits an hour, 500 a day, counted apart from new quizzes.
• 60 validations and 15 Excel previews per minute.
• 10 keys per account.

Past a limit, the agent is told how long to wait.

Keeping keys safe

• Anyone who has a key can do with your quizzes what an agent can. Treat it as a secret.
• My Account lists your keys with the date each was last used. Revoke one there and it stops working at once.
• Deleting your account revokes every key.