Install Jentic One Beta

Connect the QuizAPI to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the QuizAPI, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fquizapi.io%2Fquizapi-io" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fquizapi.io%2Fquizapi-io" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with QuizAPI API.

Search published quizzes by category, difficulty, tags, or a free-text topic with limit and offset pagination

Fetch the ordered questions for one quiz by passing quiz_id, with answers included when include_answers is true

Browse questions across all published quizzes filtered by category, difficulty, type, and tags

Shuffle a browse-mode question set with random=true to build a fresh practice round

GET STARTED

Start building with QuizAPI API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use QuizAPI API for, with concrete tasks.

★ AI tutor that quizzes a learner through Jentic

An AI tutoring agent needs real questions with answer keys rather than inventing them. Through Jentic the agent searches for 'get quiz questions by topic', loads the QuizAPI questions operation with its input schema, and pulls questions filtered by category and difficulty with the bearer key injected at call time. Because answers and explanations come back with each question, the agent can mark a learner's response and explain the correct option.

Call GET /api/v1/questions with category 'Programming', difficulty 'MEDIUM', limit 5, and random 'true', then ask the learner each question and grade the reply against the answer whose isCorrect is true

Topic-based quiz discovery

A learning app lets users type a subject and pick a ready-made quiz. The QuizAPI quizzes operation accepts a free-text topic searched across title, description, and tags, plus category and difficulty filters, and returns each quiz with its questionCount and plays. The app can sort or present the matches and page through results with limit and offset.

Call GET /api/v1/quizzes with topic 'docker', difficulty 'EASY', and limit 10, then return the title, questionCount, and id of each quiz

Run a full quiz with answer key

Once a quiz is chosen, a study tool needs its questions in order with the answer key. Passing quiz_id to the questions operation returns the ordered questions for that quiz, and setting include_answers to true adds each answer with its isCorrect flag. The tool can then present the quiz, score it, and show the explanation for questions the user missed.

Call GET /api/v1/questions with quiz_id 'cm3abc123def456' and include_answers 'true', then build a scored answer sheet from the returned answers

Filter-aware question bank setup

Before building filters in a UI or prompt, an integration reads the QuizAPI metadata operation, which needs no API key and returns the categories, tags, difficulties, and question types the bank supports. The integration uses those values to offer only valid filter options when browsing questions.

Call GET /api/v1/metadata and list the categories and question types it returns so the user can choose filters

Key Endpoints

3 endpoints — the quizapi api serves published quiz content and individual quiz questions across categories such as programming and science.

METHOD

PATH

DESCRIPTION

GET

/api/v1/questions

Get questions for a quiz or browse all questions

GET

/api/v1/quizzes

List and search published quizzes

GET

/api/v1/metadata

Get categories, tags, difficulties, and question types

GET

/api/v1/questions

Get questions for a quiz or browse all questions

GET

/api/v1/quizzes

List and search published quizzes

GET

/api/v1/metadata

Get categories, tags, difficulties, and question types

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring QuizAPI by hand means issuing a key, sending it as a bearer token, and remembering that the questions operation switches between quiz_id mode and browse mode with different filters. Through Jentic you install once, import QuizAPI from the API Directory, store the key once, and your agent calls it.

Permission scoping

QuizAPI selects quizzes and questions through query parameters rather than URL path ids, so rules bound which of its read operations your agent may call, not which quiz it reads. You choose the operations it may call, such as fetching questions without listing quizzes.

Credential isolation

Your QuizAPI 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.

Intent-based discovery

Agents search Jentic by intent such as 'get quiz questions by topic' or 'find a quiz about Python', and Jentic returns the matching QuizAPI operation with its input schema, including the difficulty enum and pagination parameters.

FAQs

Specific to using QuizAPI API through Jentic.

What authentication does the QuizAPI API use?

QuizAPI declares HTTP bearer authentication in its OpenAPI spec: you pass your API key as a bearer token in the Authorization header. The metadata endpoint, GET /api/v1/metadata, is marked as needing no key, while the quizzes and questions operations expect the token. Through Jentic the key is held by your own instance and attached at call time.

Can I get random quiz questions with answers from the QuizAPI API?

Yes. Call GET /api/v1/questions without quiz_id to enter browse mode, filter by category, difficulty, type, or tags, and set random to true to shuffle the results. In browse mode answers are always included, each with an isCorrect flag, and limit accepts 1 to 50 questions per page.

What are the rate limits for the QuizAPI API?

The OpenAPI spec does not specify rate limits. Check the QuizAPI site at https://quizapi.io/ for the current limits on your plan.

Is there a QuizAPI MCP server?

You don't need an MCP server to give your agent QuizAPI. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the quiz and question operations on demand without loading extra tool definitions into its context.

How do I pull questions for a quiz through Jentic?

Search Jentic for 'get quiz questions by topic', load the GET /api/v1/questions operation, and run it with a quiz_id and include_answers set to true to receive the ordered questions with their answers. Use GET /api/v1/quizzes with a topic first if you need to find the quiz id. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Can I limit what my agent is allowed to do with the QuizAPI API?

Yes. For example, write a rule that allows only the questions operation, so your agent can fetch questions and answers but cannot list quizzes or call anything else, and each call it makes is logged for review.

QuizAPI

Browse all Quizapi APIs

Official vendor OpenAPI document · agent-readyEducationAssessmentbearer3 EndpointsREST

For Agents

Find published quizzes by topic, category, or difficulty and pull their questions, answers, and explanations, or browse a randomized question set across all quizzes.

Use for: Find a medium-difficulty JavaScript quiz, Get the questions and correct answers for a specific quiz, Retrieve ten random HARD programming questions, List all quiz categories QuizAPI offers

Not supported: Does not create or edit quizzes, record learner scores, or host embeddable quiz widgets. Use for reading published QuizAPI quizzes and questions only.

The QuizAPI API serves published quiz content and individual quiz questions across categories such as programming and science. It lists approved quizzes filtered by category, difficulty, tags, or a free-text topic, and returns the ordered questions for a chosen quiz with optional answers. A browse mode pulls questions across all published quizzes by category, difficulty, question type, and tags, with optional random shuffling. A public metadata endpoint reports the available categories, tags, difficulties, and question types.

Jentic One on Github View OpenAPI Document