# Agent Score

> For the complete documentation index, see [llms.txt](/llms.txt).

Free tool that scores how well AI agents can read a docs site, from 0 to 100, using the open-source afdocs checks. Public reports, score history, and fixes.

Agent Score runs [afdocs](https://github.com/agent-ecosystem/afdocs) against a public docs site and returns a score out of 100 across 28 checks in 7 categories, a fix for each failing check, and score history. No signup. Every report is public at `https://promptless.ai/agent-score/<host>[/<path>]`, for example [promptless.ai/docs](https://promptless.ai/agent-score/promptless.ai/docs.md). Append `.md` to any report URL for its markdown version.

## Score a public site

Open https://promptless.ai/agent-score and enter the root URL of a docs site, such as `docs.example.com`. A scan takes about a minute. `docs.example.com` and `example.com/docs` are scored separately. A site scanned in the last 10 minutes returns the cached result.

afdocs assumes you scan the root of a docs site: it tests only the pages under the URL you enter. Agent Score helps you pick that URL. If the URL you enter looks like a single page, the form suggests the docs root instead. If a scan tests fewer than 5 pages, the report shows a partial score and says why. Where it can, the report offers a URL to rescan, such as the folder that holds your llms.txt. When Agent Score can't find the docs root, the report leaves the choice of URL to you.

The public JSON API lives at `https://api.gopromptless.ai/public/free-tools/agent-score`:

- `POST /scans` with `{"url": "https://docs.example.com"}` starts a scan and returns `scanId` and `slug`.
- `GET /scans/<scanId>` returns `status` (`queued`, `running`, `complete`, or `failed`) and `progress`.
- `GET /sites/<slug>` returns the latest result, history, and changes since the previous scan.
- `GET /sites/<slug>/badge.svg` returns an SVG badge.
- `GET /leaderboard?sort=top|recent&limit=24` lists scored sites.

## Score a private site

Agent Score is a hosted run of afdocs and nothing more. The same command on a staging site, a localhost build, or docs on your VPN gives the same score. afdocs is MIT-licensed, written by [Dachary Carey](https://github.com/dacharyc), and implements the [Agent-Friendly Docs Spec](https://agentdocsspec.com/spec/web/). Promptless adds no checks and changes no weights. Needs Node 22 or later:

```bash
npx afdocs@latest check https://docs.example.com --format scorecard
npx afdocs@latest check https://docs.example.com --fixes --verbose
```

The hosted scanner runs `afdocs check <url> --format json --score --sampling deterministic`.

## Checks

28 checks in 7 categories: content discoverability, markdown availability, page size, content structure, URL stability, observability, and authentication. Every check is a yes-or-no test an HTTP client can run; none of them read your prose. See the [check reference](https://afdocs.dev/checks/) and [how the score is calculated](https://afdocs.dev/agent-score-calculation).

## Auditing the content itself

Agent Score checks plumbing, not content. It cannot tell you whether your docs answer the questions agents get asked. For that, [sign up for Promptless](https://accounts.gopromptless.ai/sign-up) and run a content strategy audit on your docs. Free 14-day trial, no credit card. See also [how we scored 100 on agent-friendly docs](https://promptless.ai/blog/technical/agent-friendly-docs-necessary-not-sufficient.md).

Built by Promptless. Powered by afdocs.

## Leaderboard

Latest completed scan per site, highest score first. 25 sites scored.

- [help.branch.io](/agent-score/help.branch.io.md) — 100/100 (A+)
- [promptless.ai/docs](/agent-score/promptless.ai/docs.md) — 100/100 (A+)
- [developer.deel.com](/agent-score/developer.deel.com.md) — 99/100 (A)
- [docs.leapter.com](/agent-score/docs.leapter.com.md) — 98/100 (A)
- [docs.middesk.com](/agent-score/docs.middesk.com.md) — 98/100 (A)
- [docs.together.ai](/agent-score/docs.together.ai.md) — 97/100 (A)
- [developer.globalpayments.com](/agent-score/developer.globalpayments.com.md) — 96/100 (A)
- [questdb.com/docs](/agent-score/questdb.com/docs.md) — 96/100 (A)
- [resend.com/docs](/agent-score/resend.com/docs.md) — 96/100 (A)
- [code.claude.com/docs](/agent-score/code.claude.com/docs.md) — 95/100 (A)
- [zededa.mintlify.io](/agent-score/zededa.mintlify.io.md) — 93/100 (A)
- [docs.biel.ai](/agent-score/docs.biel.ai.md) — 92/100 (A)
- [docs.jive-mail.app](/agent-score/docs.jive-mail.app.md) — 91/100 (A)
- [docs.stripe.com](/agent-score/docs.stripe.com.md) — 90/100 (A)
- [airtable.com/developers/agents](/agent-score/airtable.com/developers/agents.md) — 89/100 (B)
- [www.framer.com/developers](/agent-score/www.framer.com/developers.md) — 87/100 (B)
- [developers.pismo.io](/agent-score/developers.pismo.io.md) — 86/100 (B)
- [questdb.com](/agent-score/questdb.com.md) — 81/100 (B)
- [zededa.mintlify.site](/agent-score/zededa.mintlify.site.md) — 73/100 (C)
- [docs.digital.ai/agility](/agent-score/docs.digital.ai/agility.md) — 59/100 (F)
- [my.ciena.com/CienaPortal/s/documentation](/agent-score/my.ciena.com/CienaPortal/s/documentation.md) — 59/100 (F)
- [help.thermocalc.com/2026b](/agent-score/help.thermocalc.com/2026b.md) — 56/100 (F)
- [docs.teradata.com](/agent-score/docs.teradata.com.md) — 54/100 (F)
- [help.zededa.com](/agent-score/help.zededa.com.md) — 38/100 (F)
- [www.aspirella.in](/agent-score/www.aspirella.in.md) — 36/100 (F)
