canonical: https://jentic.com/apis/fluotest.com/fluotest # FluoTest API The FluoTest API creates and manages quizzes over a JSON-RPC endpoint, so an agent can build an assessment and read how it performed. It creates a quiz and its questions, lists existing quizzes, reads a quiz's questions and settings, updates a quiz, and publishes it so it can be taken. Once a quiz is live it returns the results, and a quiz that is no longer needed can be deleted. A health endpoint confirms the service is up before a call. ## For AI agents Create and manage quizzes over a JSON-RPC endpoint: build a quiz and its questions, list quizzes, read questions and settings, update, publish, read results, and delete. ## Scope Does not handle proctoring, grading rubrics, or learner enrolment. Use for creating, publishing, and reading quizzes only. ## Capabilities - Create a quiz and add its questions - List the quizzes in an account - Read a quiz's questions and its settings - Update an existing quiz - Publish a quiz so it can be taken - Retrieve a published quiz's results - Delete a quiz that is no longer needed ## Use cases ### Agent quiz creation An AI agent connected through Jentic builds an assessment from a topic by creating a quiz and its questions and then publishing it, so a teacher or trainer gets a ready-to-take quiz without the developer wiring the JSON-RPC transport or the auth by hand. Example prompt: Create a quiz with five questions on a topic and publish it so learners can take it ### Assessment lifecycle management A course tool lists existing quizzes, reads a quiz's questions and settings to review it, updates the wording, and republishes, keeping a bank of assessments current without editing each one in a dashboard. Example prompt: List the quizzes, read one quiz's questions and settings, update a question, and republish it ### Results retrieval A reporting assistant retrieves a published quiz's results so it can summarise how learners did and flag questions that most people missed, reading the results directly rather than exporting a spreadsheet. Example prompt: Retrieve a published quiz's results and summarise the score distribution for the teacher ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/api/mcp` | Send a quiz tool request over JSON-RPC | | GET | `/api/mcp` | Open the server-to-client event stream | | DELETE | `/api/mcp` | Terminate a session | | GET | `/api/health` | Service health check | ## Key resources - **Quizzes** — Create, list, read, update, publish, and delete quizzes over the JSON-RPC endpoint - **Results** — Retrieve a published quiz's results - **Status** — Confirm the service is up before a call ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 74 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 68 / 100 - AI-Readiness & Agent Experience: 66 / 100 - Agent Usability: 94 / 100 - Security: 75 / 100 - AI Discoverability: 53 / 100 - **View full report:** https://jentic.com/apis/fluotest.com/fluotest/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring FluoTest by hand means handling its bearer API key or OAuth2 sign-in and speaking its JSON-RPC transport to reach each quiz operation yourself. Through Jentic you install once, import FluoTest from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** FluoTest carries the quiz operation and its arguments in the JSON-RPC request body, so rules bound which operations your agent may call, not which quiz. Limit it to the quiz-create and quiz-read operations, so publishing and deleting quizzes stay out of reach unless you add those operations. - **Credential handling:** Your FluoTest key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'create a quiz' or 'read a quiz's results', and Jentic returns the matching FluoTest operation with its input schema so the agent calls the right operation without reading the reference docs. ## Related APIs - **Typeform** — Form and quiz builder with a broader form model rather than a quiz-first assessment surface - **SurveyMonkey** — Survey platform with quiz features rather than a dedicated quiz lifecycle - **Open Trivia Database** — A free bank of trivia questions that can seed a quiz's content ## FAQ ### What authentication does the FluoTest API use? The FluoTest API authenticates with either a personal API key sent as a bearer token or an OAuth2 sign-in, per its OpenAPI spec. The health check needs no credential. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never lands in the agent's context. ### Is there a FluoTest MCP server? Yes. FluoTest's own surface speaks the Model Context Protocol over a JSON-RPC endpoint. You can also connect it directly through Jentic from the API Directory: your agent reaches the quiz operations through one gateway, your credential is injected at call time by your self-hosted instance instead of living in a config file, and your rules decide which operations the agent may call. ### Can I limit what my agent is allowed to do with the FluoTest API? Yes. The quiz tool and its arguments travel in the JSON-RPC request body, so a rule bounds which operations the agent may call. Allow only the quiz-create and quiz-read operations, so the agent can build and inspect quizzes but cannot publish or delete them, with every call logged. ### Can I read a quiz's results with the FluoTest API? Yes. Once a quiz is published, a results request returns how it performed, so an agent can summarise scores and flag the questions most learners missed without exporting a spreadsheet. ### What are the rate limits for the FluoTest API? The OpenAPI spec does not specify rate limits. Check the vendor documentation at https://fluotest.com/en/docs/api-reference for current limits before creating many quizzes. ### How do I create a quiz through Jentic? Search Jentic for 'create a quiz', which returns the FluoTest quiz-create operation with its input schema, then send the questions and publish the quiz. To run it on your own infrastructure, install Jentic One from its GitHub repo.