# PlanetScale — API Agent Score

> Score: 87/100 (Grade: A) | Domain: planetscale.com | Rubric: 1.0.0 | Checked: July 24, 2026

PlanetScale scored 87/100 (A), classified "ai-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/planetscale)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 87/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 66/100 (C)
- Agent Discovery: 96/100 (A+)
- Agent Understanding: 85/100 (A)
- Agent Usability: 84/100 (A)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="v1") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 28/28 enums are named types (not bare strings). Investigated: sdk 100%, spec 67%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: docs 100%, spec 50%, wellknown 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, spec 0%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://auth.planetscale.com/sign-up; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Description completeness — 97% of operations + parameters have substantive descriptions. Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://planetscale.com/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] llms.txt present, valid & comprehensive — llms-full.txt reachable at https://planetscale.com/docs/llms-full.txt. Investigated: docs 100%, sdk 0%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/planetscale, 8371 snippets). Investigated: docs 100%, cli 100%, sdk 67%.
- [warn] Crawlable / AEO — Sitemap present (6 entries) but carries no lastmod values. Investigated: wellknown 75%.
- [skip] Docs reachable, not hard auth-gated — No surface produced evidence for this capability in this run.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 6 distinct 4xx/5xx response codes documented. Investigated: spec 100%, docs 100%.
- [pass] Operation purpose clarity — 100% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [pass] Docs structured data — JSON-LD Article markup on 17/18 assessed pages (94%) with dateModified present. Investigated: docs 100%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 16% (threshold 35% for full credit).
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [skip] Agent-navigable, token-efficient docs — No surface produced evidence for this capability in this run.

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://planetscale.com/docs/api/reference/rate-limits. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 50 list endpoint(s). Investigated: spec 100%, docs 100%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

PlanetScale's API program shows strong crawlability and description quality, but two areas are holding back partner and agent adoption: agents lack the structured instruction context and runnable examples they need to integrate correctly, and human partners face a steep onboarding ramp with no quickstart or inline code samples. Prioritize giving agents executable, trustworthy context first, then compress the human onboarding path to get partners to their first successful call in minutes.