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,10 +2,9 @@
   "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" },
+    { "name": "neon", "ref": "8a4200b2fdf8c4a5b301c717064d8aeb58c8eea5" },
     {
       "name": "neon-postgres-agent-platforms",
       "ref": "main",

content/docs/ai/agent-skills.md

@@ -143,20 +143,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
 
@@ -198,7 +197,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/cli/claim.md

@@ -0,0 +1,93 @@
+---
+title: 'Neon CLI command: claim'
+subtitle: Create and claim a temporary Neon project without an account
+summary: >-
+  The Neon CLI `claim` command (`neon claimable` is an alias) creates a
+  temporary Neon project before anyone signs in. The CLI stores an identity
+  assertion, writes credentials to `.env`, and later opens a claim URL so a
+  human can take the project. See [Claimable Neon](/docs/reference/claimable-neon).
+enableTableOfContents: true
+---
+
+The `claim` command creates a temporary Neon project when there is no Neon account yet. `neon claimable` is an alias. The CLI stores an identity assertion on the machine, writes provisioned variables to `.env` (or `.env.local`), and later opens a claim URL so a human can take the project into their organization.
+
+If `neon claim` is not a command, or `neon claim --help` does not list `create`, install the latest CLI (`npm i -g neon@latest`) or use the HTTP flow in [Claimable Neon](/docs/reference/claimable-neon).
+
+Do not pass `--api-key` or `--profile`. Those are refused. `neon auth` and `neon init --agent` need a human Neon account; use this command instead when there is none.
+
+Start in the browser at [neon.com/claimable-neon](/claimable-neon), or give an agent [`auth.md`](https://neon.com/auth.md).
+
+<CliSubcommands command="claim" />
+
+## neon claim create (#create)
+
+Creates a temporary project and saves its identity assertion. Postgres is always requested. Pass `--service` for Data API, Managed Better Auth, or other services. If a [`neon.ts`](/docs/reference/neon-ts) file is present, declared services are requested automatically.
+
+<CliUsage command="claim create" />
+
+<CliOptions command="claim create" />
+
+```bash
+neon claim create --env-pull
+```
+
+```bash
+neon claim create \
+  --service data-api \
+  --service auth \
+  --env-pull
+```
+
+`--env-pull` is on by default. It writes provisioned vars to an existing `.env`, otherwise `.env.local`, and gitignores that file. If `.env` or `.env.local` already has a `DATABASE_URL` (or other Neon-managed keys), pass `--file <path>` or `--no-env-pull`.
+
+After create, regular Neon CLI commands use the saved assertion. Explicit Neon account credentials take precedence when you pass them.
+
+## neon claim status (#status)
+
+Shows the linked claimable project's lifecycle and claim status.
+
+<CliUsage command="claim status" />
+
+<CliOptions command="claim status" />
+
+```bash
+neon claim status
+```
+
+## neon claim accept (#accept)
+
+Creates a claim code and opens the URL where a human signs in and takes the project. `--open` is on by default. `--no-open` prints the URL.
+
+<CliUsage command="claim accept" />
+
+<CliOptions command="claim accept" />
+
+```bash
+neon claim accept --no-open
+```
+
+Opening the URL does not freeze access. Continuing to Neon from that URL starts the transfer and rotates `DATABASE_URL` before the console org picker.
+
+## neon claim list (#list)
+
+Lists claimable projects saved on this machine.
+
+<CliUsage command="claim list" />
+
+<CliOptions command="claim list" />
+
+```bash
+neon claim list
+```
+
+## neon claim delete (#delete)
+
+Permanently deletes the linked unclaimed project. Pass `--yes` to skip the confirmation prompt.
+
+<CliUsage command="claim delete" />
+
+<CliOptions command="claim delete" />
+
+```bash
+neon claim delete --yes
+```

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-25T17:49:33.991Z'
 ---
 
 Neon provides multiple options for integrating Postgres into your platform, application, or service. Choose the integration approach that best matches your use case.
@@ -63,7 +63,7 @@ Use this approach when you want to create databases for your users without requi
 - Instant database provisioning with no user signup required
 - 72-hour database lifespan if not claimed
 - Seamless ownership transfer when users are ready
-- Connection strings remain valid after claiming
+- Claiming moves the project into the user's organization. neon.new keeps the connection string; Claimable Neon rotates `DATABASE_URL`
 - Configurable transfer request expiration
 
 **Example use cases:**
@@ -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-25T17:09:07.082Z'
 ---
 
 [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). That template provisions a database without signup. The current no-signup project flow is [Claimable Neon](/docs/reference/claimable-neon). Unclaimed projects expire in 72 hours.
 
 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