# Neon — API Agent Score

> Score: 75/100 (Grade: B) | Domain: neon.tech | Rubric: 1.0.0 | Checked: July 24, 2026

Neon scored 75/100 (B), classified "partially-ready".

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

## Summary

- Overall: 75/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 52/100 (D)
- Agent Discovery: 75/100 (B)
- Agent Understanding: 79/100 (B)
- Agent Usability: 67/100 (C)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="v2") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 121/121 (100%) public params are fully typed (no any/**kwargs). Analyzer confirms all methods have a derivable input schema. Investigated: sdk 100%, spec 67%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, spec 0%.

### Developer Experience

- [pass] Description completeness — 95% of operations + parameters have substantive descriptions. Investigated: spec 100%, sdk 100%.
- [pass] Changelog published — changelog documented in the docs site at https://neon.com/docs/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Self-service developer portal — Signup page is sales-gated (contact-sales/request-access language detected). Investigated: docs 0%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [skip] Code samples in docs — No surface produced evidence for this capability in this run.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (websites/neon, 12157 snippets). Investigated: docs 100%, sdk 100%, cli 0%.
- [warn] llms.txt present, valid & comprehensive — Could not test any pages; 1 failed to fetch. Investigated: docs 70%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — 1 JavaScript redirect(s) detected across 1 pages. Investigated: docs 50%.
- [warn] Crawlable / AEO — No sitemap discoverable via robots.txt or /sitemap.xml on the docs host. Investigated: wellknown 50%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 7 distinct 4xx/5xx response codes documented. Investigated: docs 100%, sdk 100%, spec 50%.
- [pass] Operation purpose clarity — 100% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — No pages support .md URLs (0/1 tested). Investigated: docs 69%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, sdk) is 4% (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] Docs structured data — 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] Pagination documented & consistent — pagination documented in the docs site at https://neon.com/docs/local/vscode-extension. Investigated: docs 100%, sdk 100%, spec 50%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Neon's API program shows meaningful strength in agent discoverability and doc parseability, but two areas demand immediate attention: partners currently lack a self-service onboarding path — no dedicated portal or quickstart — meaning hands-on evaluation requires friction that kills partner momentum. Compounding this, agents operating against Neon's APIs have no structured instructions file and no runnable collection with test scripts, leaving them to guess at integration patterns rather than execute reliably. Closing these gaps should be the top priority to unlock self-serve partner growth and agent-driven workflows.