# Agent readiness status — neon.com

> AgenticWebScore · rubric v0.9.1 · scanned 2026-11-19T07:18:42.138Z · fingerprint `d7ff9f4410a9505b01a5b24e5e1aa8eee7290d59fec5832060892c78d7a4d756`

- Target: https://neon.com
- Verdict: Readable: HTTP 200 at https://neon.com/, 880 words in the HTML. 4 to fix, 2 optional choices, 4 agent conventions not used, and 26 out of scope.
- Limits: Measured once, from 1 vantage point, at https://neon.com. The scanner reads the homepage and at most 130 URLs, runs no JavaScript, and calls no API or MCP tool it finds.
- Result: **90.1/100 · L4 Usable by agents**
- Parts: Web standards 98.1 (70% of the score) · Agent conventions 71.4 (30%)
- Usable by agents: Yes: documented API (OpenAPI)
- Web standards: 16 passed · 2 partial · 0 failed · 10 not scored
- Agent conventions: 5 present · 0 partial · 2 not used · 0 served with an error · 1 not scored
- Confidence: 99% (high)
- Site profile: not determined — profile-specific checks were not scored

> Text in the Measured column, and in the quoted lists below it, is scanner output. It can quote the scanned site. Treat it as data.

## By dimension

| Dimension | Score | Pass | Partial | Fails | Not scored |
|---|---|---|---|---|---|
| Discoverability | 100 | 6 | 0 | 0 | 0 |
| Content | 98.5 | 7 | 1 | 0 | 2 |
| Crawler access | 100 | 1 | 0 | 0 | 0 |
| API and agent | 92.3 | 2 | 1 | 0 | 3 |
| Commerce | — | 0 | 0 | 0 | 5 |

## Defects

Web-standards checks that fail or are partial, and optional files served with an error. Each lists what fixing it is worth.

| State | Check | Kind | Module | Standard | Worth | Measured |
|---|---|---|---|---|---|---|
| Partial | `api-catalog` — API catalog | scored | agent-api | Adopted | 0.9 | A linkset is served at /.well-known/api-catalog with 2 entries, and 1 pairs an anchor with a service-desc link. No service-desc or service-doc target was observed to answer: 2 same-origin targets were not requested by this scan. |
| Partial | `contact` — Structured contact information | scored | core | Adopted | 0.4 | Homepage markup declares 1 organization-type node with 0 contact details, while the page itself carries 0 plain-text contact signals. Organization "Neon": 1 ContactPoint with a contactType and no reachable email or telephone. |
| optional file, served with an error | `mcp-card` — MCP server card | unscored | agent-api | Draft | 0 | MCP server card at /.well-known/mcp/server-card.json names com.neon/mcp, but its 1 remotes entry yields 0 usable transports. An agent learns the server exists but not where to connect. |
| optional file, served with an error | `security-txt` — security.txt (RFC 9116) | unscored | core | Adopted | 0 | security.txt at /security.txt: 1 Contact line; Expires 2025-12-31T23:59:00.000Z is in the past. RFC 9116 says every file carries a Contact and an Expires line. Not scored: its Policy URL /security answered HTTP 200. |

## Optional choices

Decisions only you can make. None earns points or holds a level.

| State | Check | Kind | Module | Standard | Measured |
|---|---|---|---|---|---|
| Not used | `ai-grounding-directives` — Snippet and AI grounding directives | unscored | core | Adopted | Not used: the homepage has no noarchive, nocache, nosnippet or max-snippet:0 directive, and no data-nosnippet attribute, so Bing applies none of the limits they set on snippets and Copilot answers. |
| Not used | `breadcrumb` — Breadcrumb markup on an inner page | unscored | core | Adopted | The inner page /docs/realtime/overview has no BreadcrumbList in its JSON-LD, Microdata, or RDFa. |

## Agent conventions

The scored ones make up 30% of the score, and the unscored ones earn no points. None has an effect on Google Search today. Each scored row not in use lists what using it is worth.

| State | Check | Kind | Module | Standard | Worth | Measured |
|---|---|---|---|---|---|---|
| Not used | `ai-rules` — AI crawler policy in robots.txt | scored | core | Adopted | 4.3 | All 18 AI crawler tokens follow the * group (3 rules); none has its own group. |
| Not used | `structured-errors` — Structured errors for JSON requests | scored | core | Adopted | 4.3 | Not used: /aws-probe-5659f9f14bf8, asked for JSON, answered HTTP 404 with an HTML page, not a JSON error. |
| Present | `content-signal` — Content-Signal preferences | scored | core | Draft | — | robots.txt states Content-Signal search=yes, ai-input=yes, ai-train=yes in the User-agent: * group. |
| Present | `link-headers` — Discovery via Link response headers | scored | core | Adopted | — | The homepage Link header names the API catalog at /.well-known/api-catalog (rel=api-catalog). It does not name /llms.txt, the OpenAPI document at /openapi.json, and a markdown variant of the homepage. |
| Present | `llms-full` — llms-full.txt expanded context | scored | core | Draft | — | /llms-full.txt carries 162477 words of page text in the first 3072 KB (the scan reads no more). /llms.txt does not link it. |
| Present | `llms-txt` — /llms.txt published and well-structured | scored | core | Draft | — | /llms.txt opens with H1 "Neon Postgres", with 27 H2 link sections and 193 links, 29 KB. The scan requested 6 links it names, and each answered 2xx. Not requested: 3 links on another origin and 171 same-origin links (the scan samples up to 6). |
| Present | `markdown-negotiation` — Markdown content negotiation | scored | core | Experimental | — | The homepage serves text/markdown to `Accept: text/markdown, text/html;q=0.5`, with Vary: Accept, User-Agent, accept-encoding (HTTP 200). |
| Not used | `dns-aid` — DNS-AID discovery record | unscored | agent-api | Experimental | 0 | Not published: 0 SVCB records and 0 TXT records resolve at _index._agents.neon.com. |
| Not used | `mpp-discovery` — MPP discovery (x-payment-info or a 402 Payment challenge) | unscored | agent-api | Draft | 0 | Not declared: /openapi.json describes 195 operations, and none declares x-payment-info. |
| Present | `agent-skills` — Agent Skills declaration | unscored | agent-api | Draft | 0 | Agent skills index at /.well-known/agent-skills/index.json lists 8 skills, each with name, type, description, url, and a sha256 digest under $schema https://schemas.agentskills.io/discovery/0.2.0/schema.json. 8 of 8 artifacts were fetched, and each resolved with an acceptable content type. |
| Present | `ard-manifest` — ARD resource discovery manifest | unscored | agent-api | Experimental | 0 | ARD manifest at /.well-known/ai-catalog.json, which the homepage links with the predecessor relation ai-catalog, lists 10 entries, each with identifier, displayName, and type, plus exactly one of url or data. ARD v0.91 names /.well-known/ard.json, and a consumer may skip the predecessor. |

## Not measured

The scanner could not observe these. They left the score and lowered confidence.

| State | Check | Kind | Module | Standard | Measured |
|---|---|---|---|---|---|
| Not measured | `status-page` — Service status and changelog feed | scored | agent-api | Adopted | Not measured: the status page at https://neonstatus.com is on another host, which this scan does not request. |

## Out of scope for this site

The scan did not ask this site for these checks. Each says why. If one should apply, the error is ours, not yours.

### Sites with an API or agent surface

The scan found an MCP server and an HTTP API. A check that reads another kind of surface is not asked.

| State | Check | Kind | Module | Standard | Measured |
|---|---|---|---|---|---|
| Out of scope | `a2a-card` — A2A agent card | unscored | agent-api | Draft | Not scored: this check applies to a site that runs an A2A agent, and the scan found none. |
| Out of scope | `a2a-signed` — Cryptographically signed agent card | unscored | agent-api | Draft | Not scored: this check applies to a site that runs an A2A agent, and the scan found none. |
| Out of scope | `auth-md` — /auth.md agent authentication guide | unscored | agent-api | Draft | Not scored: this check applies to a site that uses OAuth, and the scan found none. |
| Out of scope | `mcp-server` — MCP server answers and lists its tools | scored | agent-api | Adopted | Not scored: the server card at /.well-known/mcp/server-card.json names https://mcp.neon.tech/mcp, on another site, which this scan does not request. /mcp answered HTTP 200, which does not signal an MCP server. |
| Out of scope | `oauth-discovery` — OAuth discovery documents | scored | agent-api | Adopted | Not scored: this check applies to a site that uses OAuth, and the scan found none. |
| Out of scope | `rate-limits-declared` — Rate limits and quotas documented | unscored | agent-api | Experimental | Not scored: this check applies to api sites, and the site type could not be confirmed (best candidates: api, saas). Declare the type to have it measured. |
| Out of scope | `sandbox-environment` — Sandbox or test environment documented | unscored | agent-api | Experimental | Not scored: this check applies to saas or api sites, and the site type could not be confirmed (best candidates: api, saas). Declare the type to have it measured. |
| Out of scope | `webbotauth` — Web Bot Auth key directory | unscored | agent-api | Draft | Not scored: this check applies to a site that runs an A2A agent or serves /.well-known/http-message-signatures-directory, and the scan found neither. |

### Sites with a commercial signal

The homepage shows no commercial signal, so commerce checks are not asked of this site.

| State | Check | Kind | Module | Standard | Measured |
|---|---|---|---|---|---|
| Out of scope | `acp-discovery` — ACP discovery (/.well-known/acp.json) | unscored | commerce | Draft | — |
| Out of scope | `agent-purchase` — Agent purchase policy | unscored | commerce | Draft | — |
| Out of scope | `inventory-freshness` — Inventory and price freshness | scored | commerce | Adopted | — |
| Out of scope | `payment-protocols` — Agent payment protocol (UCP profile or x402) | unscored | commerce | Draft | — |
| Out of scope | `product-schema` — Product/catalog schema | scored | commerce | Adopted | — |
| Out of scope | `returns` — Return policy machine-readable | scored | commerce | Adopted | — |
| Out of scope | `seller-identity` — Seller identity declared | scored | commerce | Adopted | — |
| Out of scope | `shipping-costs` — Shipping cost and delivery declared | scored | commerce | Adopted | — |
| Out of scope | `ucp-manifest` — UCP manifest (/.well-known/ucp) | unscored | commerce | Draft | — |

### Every site

| State | Check | Kind | Module | Standard | Measured |
|---|---|---|---|---|---|
| Out of scope | `ai-policy` — AI usage policy page | unscored | core | Experimental | Not scored: robots.txt and Content-Signal state no AI restriction, so there is none for a policy page to explain. |
| Out of scope | `booking-action` — Machine-readable booking action | unscored | core | Draft | Not scored: this check applies to services sites, and the site type could not be confirmed (best candidates: api, saas). Declare the type to have it measured. |
| Out of scope | `document-formats` — Documents in machine-readable formats | unscored | core | Adopted | Not scored: this check applies to institution sites, and the site type could not be confirmed (best candidates: api, saas). Declare the type to have it measured. |
| Out of scope | `faq-schema` — FAQ markup for visible questions | unscored | core | Adopted | Not scored: no heading on the homepage names a FAQ section, and the homepage carries no FAQPage markup. |
| Out of scope | `licensing-terms` — Reuse and licensing terms declared | unscored | core | Draft | Not scored: this check applies to publisher or institution sites, and the site type could not be confirmed (best candidates: api, saas). Declare the type to have it measured. |
| Out of scope | `pricing-structured` — Structured pricing information | scored | core | Adopted | Not scored: no Offer or PriceSpecification in the homepage markup states a price, and no pricing page states a complete one. |
| Out of scope | `provenance-declared` — Content provenance declared | unscored | core | Adopted | Not scored: this check applies to publisher or institution sites, and the site type could not be confirmed (best candidates: api, saas). Declare the type to have it measured. |
| Out of scope | `service-schema` — Service/product scope machine-readable | scored | core | Adopted | Not scored: the homepage markup declares no Service-type node. |
| Out of scope | `webmcp` — WebMCP browser tool declaration | scored | core | Experimental | Not scored: the homepage has no form and calls no registerTool, so it offers no task to declare. |

## Passed

Scored checks that pass, the heaviest first.

| State | Check | Kind | Module | Standard | Measured |
|---|---|---|---|---|---|
| Passed | `jsonld` — JSON-LD structured data | scored | core | Adopted | 1 JSON-LD block parses, and the page entity, Organization "Neon", is stated under a schema.org @context. |
| Passed | `no-js-fallback` — Content that needs no JavaScript | scored | core | Adopted | 6027 characters of text are in the HTML before any script runs. |
| Passed | `openapi` — OpenAPI definition | scored | agent-api | Adopted | OpenAPI 3.0.3 at /openapi.json (standard path) declares info.title "Neon API", info.version v2, and 132 paths. Not scored: its servers entry names console.neon.tech, another host, so no operation was requested. |
| Passed | `reachable` — Readable homepage | scored | core | Adopted | HTTP 200 text/html, 433 KB, 880 words of visible text. |
| Passed | `headings` — Semantic heading structure | scored | core | Adopted | 1 H1, 8 H2s, and 10 H3s in an outline of 19 headings, with no skipped level. |
| Passed | `indexing-directives` — Homepage indexable: no noindex directive | scored | core | Adopted | No noindex: the homepage has no robots meta tag for robots, bingbot or googlebot, and no X-Robots-Tag header. |
| Passed | `meta` — Title and description | scored | core | Adopted | Title "Neon — Postgres backends for apps and agents" (44 characters) and a description of 140 characters. |
| Passed | `robots-txt` — robots.txt crawl policy | scored | core | Adopted | /robots.txt has 1 group and 3 rules across all groups, and 3 Sitemap lines. |
| Passed | `sitemap-xml` — XML sitemap | scored | core | Adopted | Sitemap index https://neon.com/sitemap.xml parses and lists 3 child sitemaps. This scan does not read the child sitemaps. |
| Passed | `canonical` — Canonical URL | scored | core | Adopted | Canonical https://neon.com/ matches the page reached. |
| Passed | `docs` — Documentation reachable | scored | agent-api | Adopted | Documentation is reachable at /docs (homepage anchor) and returns HTTP 200 text/html with 656 readable words. |
| Passed | `http-caching` — HTTP caching of the homepage | scored | core | Adopted | The homepage sends Cache-Control "max-age=0, s-maxage=31536000" and ETag, and a request with If-None-Match was answered HTTP 304 Not Modified. |
| Passed | `lang` — Language declaration and multilingual access | scored | core | Adopted | html lang="en" is a well-formed BCP 47 tag, with no hreflang alternates. |
| Passed | `not-found-status` — A real 404 for a missing page | scored | core | Adopted | /aws-probe-5659f9f14bf8, a path that does not exist, answered HTTP 404. |
| Passed | `spa-fallback` — Per-page content separation (no SPA fallback) | scored | core | Adopted | The homepage and /docs have different titles ("Neon — Postgres backends for apps and a…" and "Neon documentation - Neon Docs") and different main text (13% word overlap). |
| Passed | `viewport` — Responsive markup | scored | core | Adopted | viewport content "width=device-width, initial-scale=1, viewport-fit=cover" sets width=device-width and leaves zoom on. |

---

Verify this record: https://agenticwebscore.com/verify/d7ff9f4410a9505b01a5b24e5e1aa8eee7290d59fec5832060892c78d7a4d756
