Published 2026-09-21 · Tested 2026-08-20

Mapbox

B-

Mapbox received 9 PASS votes and passed 4 of five agent surface checks. The clearest finding came from the configure an access token task.

Panel: GPT 5.6 Sol, Opus 5, DeepSeek v4F Battery: v1 Read as markdown (opens in a new tab)

Three AI models, GPT 5.6 Sol, Claude Opus 5, and DeepSeek v4 Flash, each read Mapbox’s public documentation independently and attempted five first-hour developer jobs: make the first geocoding request, find the exact limits, recover from a 429, configure an access token, use Mapbox GL JS.

No accounts, API calls, or code execution were used. Every verdict came from public pages and every published quotation passed a live verification check. Preflight substitutions: T4: Scoped access-token authentication replaces webhooks.

Freshness

How rechecks work
Tested
Quotes verified
Surface rechecked

No change since the test.

5 of 5 quoted passages still appear on the live pages.

Mapbox Docusaurus 3.6.3 · published
B-

80.0% · 64/80 · AI Agent Readiness Score · reading 30 pts · surface 50 pts

llms.txt PASS
llms-full.txt FAIL
markdown mirror PASS
MCP server PASS
docs AI PASS
Task GPT 5.6 SolOpus 5DeepSeek v4F Consensus
Make the first geocoding request PARTIALPASSPASS PASS
Find the exact limits PASSPARTIALPASS PASS
Recover from a 429 PASSPARTIALPASS PASS
Configure an access token PARTIALPARTIALPASS PARTIAL
Use Mapbox GL JS PARTIALPASSPASS PASS

docs platform: Docusaurus 3.6.3 (unscored) · verified 2026-08-20

What to fix first

These 2 fixes could add up to 12 points to the AI Agent Readiness Score. The list ranks each fix by the points it would add. How the ranking works

  1. 1
    +10 points llms-full.txt check failed

    Found: HTTP 404 returned an HTML error page.

    Fix: Publish llms-full.txt at the docs root with the full text of every docs page in one plain-text file.

    Evidence: docs.mapbox.com/llms-full.txt (opens in a new tab)

  2. 2
    +2 points Configure an access token PARTIAL

    Found: Opus 5 found the Geocoding page names no required scope. GPT found the troubleshooting page recommends all public scopes, contrary to the token guide's least-privilege rule.

    Fix: State which scopes a geocoding token needs, and apply the least-privilege rule on the token troubleshooting page.

    Evidence: docs.mapbox.com/accounts/guides/tokens (opens in a new tab)

What the docs get right

  • Make the first geocoding request: 2 PASS votes. The Geocoding API page gives a copy-paste curl example for forward geocoding, and three separate pages agree that a ready-made default public token is waiting in the Developer Console, so no token creation is required for the first call.
  • Find the exact limits: 2 PASS votes. The pages consistently state 1,000 requests per minute, 100,000 free monthly requests, per-1,000 pricing, and autocomplete and batch counting.
  • 4 of 5 agent surface checks. Present: llms.txt, markdown mirrors, an MCP server, docs AI. Missing: llms-full.txt.

Make the first geocoding request

PASS

PASS consensus from 2 PASS, 1 PARTIAL.

The v6 curl works, but token management still shows v5, and the access-token getting-started page loads only an empty shell. The Geocoding API page gives a copy-paste curl example for forward geocoding, and three separate pages agree that a ready-made default public token is waiting in the Developer Console, so no token creation is required for the first call. All required parameters are documented on the same page; the access-token glossary provides an immediately executable URL.

Find the exact limits

PASS

PASS consensus from 2 PASS, 1 PARTIAL.

The pages consistently state 1,000 requests per minute, 100,000 free monthly requests, per-1,000 pricing, and autocomplete and batch counting. The 1000 requests-per-minute rate limit and the request-counting rules for autocomplete and batch are stated clearly on the docs page, but the free tier of 100,000 monthly requests and the $0.75 per 1,000 unit price live only on www.mapbox.com/pricing behind a collapsed accordion, and the docs never state which billing product the permanent=true parameter bills against. Rate limit scope (per access token), value (1000/min), pricing unit (per request), free tier (100k/month), and counting rules (autocomplete keystrokes, batch sub-queries) all documented; values are consistent across pages.

Recover from a 429

PASS

PASS consensus from 2 PASS, 1 PARTIAL.

The API index could not be extracted, but the guide documents per-token scope, reset timing, and sales escalation after 429. The Geocoding API page names the 429 and the 1000 per minute default but offers no Retry-After, no backoff guidance, and no link to the X-Rate-Limit-Reset header documented on the separate API guides page, and the two pages describe the limit scope differently. Limit scope (per access token) is identified; response code, headers for recovery timing, and escalation path are all documented.

Configure an access token

PARTIAL

PARTIAL consensus from 1 PASS, 2 PARTIAL.

The guides cover least-privilege scopes, URL rules, 401, and 403, but troubleshooting also recommends all public scopes. URL restrictions and the 401 and 403 diagnosis paths are complete and excellent, but least-privilege scoping for geocoding is undocumented: the default token cannot be URL-restricted, the public scopes table lists only styles:tiles, styles:read, fonts:read, and datasets:read, and the Geocoding API page names no required scope anywhere. Token creation, scope assignment, URL restrictions, and 401/403 diagnosis are fully documented on both the management guide and the troubleshooting page.

Use Mapbox GL JS

PASS

PASS consensus from 2 PASS, 1 PARTIAL.

The guide covers the task, but its JavaScript block wraps code in <script> and points to the discouraged default token. The npm guide, the CDN guide, and the examples gallery all pass the token as the accessToken option on the mapboxgl.Map constructor rather than the older mapboxgl.accessToken global, and the npm guide adds a troubleshooting checklist covering the token and the container dimensions. npm installation, import, token configuration, and map rendering are clearly documented and consistent with the scoped public-token guidance on the security page.

The receipt

To protect your account and your data, do not grant more scopes than necessary to each token.

The guides cover least-privilege scopes, URL rules, 401, and 403, but troubleshooting also recommends all public scopes.

Agent surface notes

Initialize returned an MCP Bearer OAuth challenge with valid resource metadata.

The live docs expose a public Mapbox Developer AI Assistant.

Show the score

AI Agent Readiness Score 80.0%, grade B-

Paste this into a readme:

[![AI Agent Readiness Score 80.0%](https://docsforagents.com/badge/mapbox.svg)](https://docsforagents.com/reports/mapbox-docs-ai-agent-readiness/)

Method note

This is a reading test of public documentation, not an execution test. No accounts were created and no API calls were run. The AI Agent Readiness Score counts fifteen reading votes at PASS 2, PARTIAL 1, and FAIL 0, for 30 possible points. Five agent surface checks add 10 points each. The total is 80. Consensus chips show each row majority and do not affect scoring. The panel split on 5 of five tasks. Quotes shown here were re-fetched and confirmed verbatim on 2026-08-20.

Read the full methodology

Put another docs site through the battery.

Nominate a docs site