feat: add Claimable Neon page, docs and auth.md agent discovery

.claude/neon-terminology.md

@@ -35,7 +35,7 @@ Bare "Lakebase Postgres" is a claim about the database on **either** access path
 
 Add the qualifier when the sentence touches any of these:
 
-- A Neon-only or Databricks-only feature (Managed Better Auth, Object Storage, Functions, AI Gateway, Data API, Claimable Postgres, Unity Catalog governance, high availability)
+- A Neon-only or Databricks-only feature (Managed Better Auth, Object Storage, Functions, AI Gateway, Data API, Claimable Neon, Unity Catalog governance, high availability)
 - Console or UI instructions, signup, or account creation
 - Pricing, plans, credits, or free-tier limits
 - A path-specific API, CLI, SDK, Terraform provider, or MCP Server

.env.example

@@ -4,6 +4,8 @@ NEXT_PUBLIC_GITHUB_PATH=https://github.com/neondatabase/website/tree/main/
 
 NEXT_PUBLIC_NEON_STATUS_API=https://7687492087503394.hostedstatus.com/1.0/status/6878fc85709daa75be6c7e3c
 
+CLAIMABLE_NEON_ORIGIN=https://claimable.neon.tech
+
 INKEEP_ORGANIZATION_ID=neon
 INKEEP_INTEGRATION_ID=
 INKEEP_INTEGRATION_API_KEY=

.github/workflows/agent-discovery-verify.yml

@@ -24,6 +24,7 @@ on:
       - 'src/constants/agent-discovery.js'
       - 'scripts/verify-agent-endpoints.mjs'
       - 'src/app/.well-known/**'
+      - 'public/auth.md'
       - 'src/app/models.json/**'
       - 'src/app/models/**'
       - 'src/scripts/generate-skills-index.js'

config/agent-endpoints.yaml

@@ -164,3 +164,21 @@ endpoints:
     validator: openapi
     check: live
     rewriteFile: next.config.js
+
+  - id: claimable-authorization-server
+    name: Claimable Neon authorization server
+    description: >-
+      RFC 8414 metadata for the Claimable Neon path issuer on neon.com.
+      Token, JWKS, identity, and claim endpoints stay on claimable.neon.tech.
+      The protocol file is /auth.md. The apex
+      /.well-known/oauth-authorization-server on neon.com is unused.
+    servedPath: /.well-known/oauth-authorization-server/claimable
+    contentType: application/json
+    spec:
+      name: RFC 8414 Authorization Server Metadata
+      url: https://www.rfc-editor.org/rfc/rfc8414
+      standard: true
+    validator: claimable-authorization-server
+    check: builder
+    builder: buildClaimableAuthorizationServer
+    routeFile: src/app/.well-known/oauth-authorization-server/claimable/route.js

config/skills.json

@@ -2,7 +2,6 @@
   "primary": "neon-postgres",
   "skills": [
     { "name": "neon-postgres", "ref": "main" },
-    { "name": "claimable-postgres", "ref": "main" },
     { "name": "neon-postgres-egress-optimizer", "ref": "main" },
     { "name": "neon-postgres-branches", "ref": "main" },
     { "name": "neon", "ref": "main" },

content/docs/ai/agent-skills.md

@@ -10,7 +10,7 @@ summary: >-
   with `npx skills add neondatabase/agent-skills -y`, a single skill with `-s`,
   `neon init`, or editor plugins at project level or globally.
 enableTableOfContents: true
-updatedOn: '2026-08-20T11:15:28.658Z'
+updatedOn: '2026-08-25T16:36:05.871Z'
 redirectFrom:
   - /docs/ai/ai-rules
   - /docs/ai/ai-rules-neon-toolkit
@@ -123,20 +123,19 @@ Skills are grouped by area. Each skill is a `SKILL.md` entry point that your age
 
 Start here for platform overview and Postgres development.
 
-| Skill                                                                        | Description                                                                                                                 |
-| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| [`neon`](https://skills.sh/neondatabase/agent-skills/neon)                   | Platform overview for apps and agents: Postgres, Auth, Data API, Functions, Storage, and AI Gateway, and how to get started |
-| [`neon-postgres`](https://skills.sh/neondatabase/agent-skills/neon-postgres) | Full index of Neon Serverless Postgres documentation and best practices                                                     |
+| Skill                                                                        | Description                                                                                                                                                |
+| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`neon`](https://skills.sh/neondatabase/agent-skills/neon)                   | Platform overview for apps and agents: Postgres, Auth, Data API, Functions, Storage, and AI Gateway, including Claimable Neon when there is no account yet |
+| [`neon-postgres`](https://skills.sh/neondatabase/agent-skills/neon-postgres) | Full index of Neon Serverless Postgres documentation and best practices                                                                                    |
 
 ### Database workflows
 
-Provision, branch, and optimize Postgres projects.
+Branch and optimize Postgres projects.
 
-| Skill                                                                                                          | Description                                                                                                               |
-| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| [`claimable-postgres`](https://skills.sh/neondatabase/agent-skills/claimable-postgres)                         | Instant temporary Postgres via [Claimable Postgres](/docs/reference/claimable-postgres), no login or credit card required |
-| [`neon-postgres-branches`](https://skills.sh/neondatabase/agent-skills/neon-postgres-branches)                 | Choose and create the right branch type for migrations, schema-only branches, and reset-from-parent workflows             |
-| [`neon-postgres-egress-optimizer`](https://skills.sh/neondatabase/agent-skills/neon-postgres-egress-optimizer) | Diagnose and fix excessive Postgres egress and query overfetching                                                         |
+| Skill                                                                                                          | Description                                                                                                   |
+| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| [`neon-postgres-branches`](https://skills.sh/neondatabase/agent-skills/neon-postgres-branches)                 | Choose and create the right branch type for migrations, schema-only branches, and reset-from-parent workflows |
+| [`neon-postgres-egress-optimizer`](https://skills.sh/neondatabase/agent-skills/neon-postgres-egress-optimizer) | Diagnose and fix excessive Postgres egress and query overfetching                                             |
 
 ### Neon Platform
 
@@ -178,7 +177,7 @@ With the full skill set installed, your assistant can guide you across the Neon
 
 **Database workflows**
 
-- **Disposable databases** via Claimable Postgres for agents and tests
+- **Disposable projects** via [Claimable Neon](/claimable-neon), for agents and tests
 - **Branch types and workflows** for migrations, schema-only branches, and reset-from-parent
 - **Egress optimization** for high transfer costs and query anti-patterns
 

content/docs/guides/platform-integration-overview.md

@@ -13,7 +13,7 @@ redirectFrom:
   - /docs/guides/partner-intro
   - /docs/guides/platform-integration-intro
   - /docs/guides/platform-integration-get-started
-updatedOn: '2026-08-07T17:19:40.308Z'
+updatedOn: '2026-08-25T16:36:05.871Z'
 ---
 
 Neon provides multiple options for integrating Postgres into your platform, application, or service. Choose the integration approach that best matches your use case.
@@ -79,13 +79,13 @@ Use this approach when you want to create databases for your users without requi
 
 - [TanStack](/blog/neon-joins-tanstack-instant-postgres-integration-for-faster-javascript-development): Official database partner offering instant Postgres through their Vite plugin and create-tanstack CLI
 - [Netlify DB](https://www.netlify.com/blog/netlify-db-database-for-ai-native-development/): One-click Postgres databases for Netlify projects, built on the claimable database flow
-- [Claimable Postgres by Neon](https://neon.new/): Try instant Postgres provisioning without signup using `npx neon-new` or at [neon.new](https://neon.new/)
+- [Claimable Neon](/claimable-neon): instant Neon project without signup, via the Neon CLI or [auth.md](https://neon.com/auth.md)
 
 <DetailIconCards>
 
 <a href="/docs/workflows/claimable-database-integration" description="Learn how to implement claimable databases" icon="import">Claimable database guide</a>
 
-<a href="/docs/reference/claimable-postgres" description="See Claimable Postgres implementation details" icon="transactions">Claimable Postgres documentation</a>
+<a href="/docs/reference/claimable-neon" description="See Claimable Neon implementation details" icon="transactions">Claimable Neon documentation</a>
 
 </DetailIconCards>
 

content/docs/guides/railway.md

@@ -11,7 +11,7 @@ summary: >-
   Postgres, which provisions a database instantly without signup and stays
   claimable for 72 hours.
 enableTableOfContents: true
-updatedOn: '2026-08-18T10:29:02.410Z'
+updatedOn: '2026-08-25T16:36:05.871Z'
 ---
 
 [Railway](https://railway.com?utm_medium=integration&utm_source=button&utm_campaign=neon) is a cloud deployment platform that allows users to deploy anything, anywhere, seamlessly. On Railway, develop locally, connect to a repository or image, and have infrastructure provisioned automatically. Railway integrates with GitHub for continuous deployment and supports a variety of programming languages and frameworks.
@@ -20,7 +20,7 @@ This guide shows how to deploy a simple Node.js application connected to a Lakeb
 
 ## Quick start alternative
 
-If you want to get started quickly with Next.js and Lakebase Postgres on Railway, you can use the [Next.js with Neon Postgres template](https://railway.com/deploy/nextjs-with-neon-postgres?utm_medium=integration&utm_source=button&utm_campaign=neon). This template uses [Claimable Postgres by Neon](/docs/reference/claimable-postgres) to provision a database instantly without signup, perfect for rapid prototyping. The database is claimable for 72 hours, giving you time to develop before claiming it to your Neon account.
+If you want to get started quickly with Next.js and Lakebase Postgres on Railway, you can use the [Next.js with Neon Postgres template](https://railway.com/deploy/nextjs-with-neon-postgres?utm_medium=integration&utm_source=button&utm_campaign=neon). This template uses [Claimable Neon](/docs/reference/claimable-neon) to provision a project instantly without signup, perfect for rapid prototyping. The project is claimable for 72 hours, giving you time to develop before claiming it to your Neon account.
 
 For a more detailed walkthrough using Node.js/Express with manual setup, continue with this guide below.
 
@@ -175,6 +175,6 @@ To delete your Neon project, follow the steps outlined in the Neon documentation
 
 - [Railway platform](https://railway.com?utm_medium=integration&utm_source=button&utm_campaign=neon)
 - [Next.js with Neon Postgres Railway template](https://railway.com/deploy/nextjs-with-neon-postgres?utm_medium=integration&utm_source=button&utm_campaign=neon)
-- [Claimable Postgres](/docs/reference/claimable-postgres)
+- [Claimable Neon](/docs/reference/claimable-neon)
 
 <NeedHelp/>

content/docs/guides/tanstack-start.md

@@ -12,7 +12,7 @@ enableTableOfContents: true
 redirectFrom:
   - /docs/quickstart/tanstack-start
   - /docs/integrations/tanstack-start
-updatedOn: '2026-08-04T05:18:26.469Z'
+updatedOn: '2026-08-25T16:36:05.871Z'
 ---
 
 <CopyPrompt src="/prompts/tanstack-start-prompt.md"
@@ -62,31 +62,7 @@ Add a `.env` file to your project directory and add your Neon connection string
 DATABASE_URL="postgresql://<user>:<password>@<endpoint_hostname>.neon.tech:<port>/<dbname>?sslmode=require&channel_binding=require"
 ```
 
-If you haven't created a database yet, run the following command to generate a [Claimable Postgres by Neon database](https://neon.new/). It will spin up a database instance that you can use for 72 hours, or claim to keep forever.
-
-<CodeTabs labels={["npm", "yarn", "pnpm", "bun", "deno"]}>
-
-```bash
-  npm neon-new
-```
-
-```bash
-  yarn dlx neon-new
-```
-
-```bash
-  pnpm neon-new
-```
-
-```bash
-  bunx neon-new
-```
-
-```bash
-  deno run -A neon-new
-```
-
-</CodeTabs>
+If you haven't created a project yet, [Claimable Neon](/claimable-neon) provisions a temporary Neon project without an account. A human can claim the project into a Neon account before it expires. See [Claimable Neon](/docs/reference/claimable-neon).
 
 ## Configure the Postgres client