# Quiz Tracker

> 

- Documentation: https://quiz-tracker.thally.app
- GitHub: https://github.com/SECHUBSYSTEM/quiz-tracker-docs
- Full docs for LLMs: https://quiz-tracker.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://quiz-tracker.thally.app/ai.txt
- Structured docs index (JSON): https://quiz-tracker.thally.app/api/docs-index
- OpenAPI spec: https://quiz-tracker.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://quiz-tracker.thally.app/api/docs/{page-id}
- Search API: https://quiz-tracker.thally.app/api/search?q={query}
- Capability manifest (skill): https://quiz-tracker.thally.app/skill.md
- Agent guidance (editing these docs): https://quiz-tracker.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://quiz-tracker.thally.app/api/mcp
- Agent readiness: https://quiz-tracker.thally.app/api/agent-readiness
- Changelog feed (JSON Feed): https://quiz-tracker.thally.app/changelog/feed.json
- Changelog feed (RSS): https://quiz-tracker.thally.app/changelog/rss.xml

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://quiz-tracker.thally.app/): Quiz Tracker lets you build a quiz, take it one question at a time, and keep a scored history of every attempt.
- [Quickstart](https://quiz-tracker.thally.app/quickstart): Run Quiz Tracker on your machine, build a three-question quiz, take it, and see a graded result.

### Guides

- [Drive the API from a script](https://quiz-tracker.thally.app/guides/api): Create a quiz, submit an attempt and read the graded result through the Quiz Tracker REST API, with curl or fetch.

## API Reference

### Overview

- [Overview](https://quiz-tracker.thally.app/api/introduction): What the Quiz Tracker REST API covers, its base URL, and how to make your first request.
- [Authentication](https://quiz-tracker.thally.app/api/authentication): Quiz Tracker has no authentication. Here is what that means for who can read and change data.

## Changelog

- [Changelog](https://quiz-tracker.thally.app/changelog): Changes to Quiz Tracker that affect how you install, run or call it.

Interactive API reference available at https://quiz-tracker.thally.app/api