Claimable Neon

A project when your agent needs one.

Agents can provision a Neon project before a human creates an account. Start building, then claim the project into a Neon organization before it expires.

Start with the form Read the docs

Provision

Get scoped credentials

Build

Use standard Postgres tools

Claim

Transfer to your organization

Provision from this page

Choose your backend

Lakebase Postgres

A temporary database is always included.

Included

No account or payment details required. Unclaimed projects expire in 72 hours and are capped at 100 MB storage and 1 GB transfer.

One service, three interfaces

auth.md, the Neon CLI and neon.ts

The same scoped agent credential works through auth.md, the Neon CLI, and neon.ts.

auth.md

Discover and register

Start from one text document, request capabilities, and exchange the identity assertion for short-lived access tokens.

GET https://neon.com/auth.md

POST https://claimable.neon.tech/v1/agent/identity
Content-Type: application/json

{
  "type": "anonymous",
  "capabilities": ["postgres", "data_api", "auth"]
}

Neon CLI

Use existing commands

Create a claimable project once. Branch, query, and configure it with the same CLI commands used by account-backed projects. If neon claim is not a command, use the auth.md card.

npm i -g neon@latest
neon claim create \
  --service data-api \
  --service auth \
  --env-pull

neon branches list
neon claim accept --no-open

neon.ts

Declare services

If neon.ts is present, neon claim create requests its declared services. Services that need a claimed project are recorded as denied until then.

import { defineConfig } from '@neon/config/v1';

export default defineConfig({
  auth: true,
  dataApi: true,
});

Claim

One project, a claim link, an expiry

Scoped from the first request

The service creates one project and issues credentials for that project.

Human ownership starts at claim

A short-lived claim link starts a project transfer into the Neon organization selected by the human.

Unclaimed projects expire

Unclaimed projects expire in 72 hours and are capped at 100 MB storage and 1 GB transfer. Claim the project before then to keep it. Claiming rotates DATABASE_URL; Auth and the Data API stay enabled.