---
path: /v1/glossary
title: Glossary
summary: Definitions of the terms used across the AgentFit API and reports.
group: Guides
updated: 2026-06-22
---

# Glossary

Definitions of the terms used throughout this documentation and in audit reports.

<dl>
  <dt>AI-readiness</dt>
  <dd>How well a large language model or autonomous agent can read a documentation site and
  call its API correctly without guessing, measured by the 30-criteria rubric.</dd>

  <dt>Audit</dt>
  <dd>A single evaluation of one documentation site against the rubric, producing a
  deterministic JSON report scored from 0 to 100 with per-criterion HTTP evidence.</dd>

  <dt>Base URL</dt>
  <dd>The root URL of the documentation site being audited, such as
  <code>https://docs.stripe.com</code>; all host-root discovery files are fetched relative
  to it.</dd>

  <dt>Criterion</dt>
  <dd>One of the 30 individual checks (identified A1 through F4) that make up the rubric;
  each contributes a fixed number of points to the total score.</dd>

  <dt>Category</dt>
  <dd>One of the six groups of criteria — Discovery, Page artifacts, API spec, Content,
  Hygiene, and Agent Surface — whose points sum to the 0–100 total.</dd>

  <dt>Run</dt>
  <dd>A queued or completed execution of an audit, identified by a UUID
  <code>run_id</code> that you poll until its status becomes <code>done</code>.</dd>

  <dt>llms.txt</dt>
  <dd>A standardized plain-text file at a site's root that summarizes the site for large
  language models and links to its most important pages and resources.</dd>

  <dt>MCP server</dt>
  <dd>A Model Context Protocol endpoint that lets an agent client such as Claude discover
  and call the audit tools over an authenticated transport.</dd>

  <dt>WebMCP</dt>
  <dd>Declarative markup on an HTML page that exposes a form as an agent-callable tool, so a
  browsing agent can invoke it without bespoke integration.</dd>
</dl>

Terms that map to JSON fields in a report (`total_score`, `categories`, `criteria`,
`status`, `evidence_url`) are documented inline on the
[Get an audit](https://docs.agentfit.dev/v1/reference/get-audit) reference page.