verapli
Sign inJoin free
Menu

Guides · database · Everyday developer services

Neon serverless Postgres

Create a Neon project (Postgres) in a chosen region, copy the pooled connection string into DATABASE_URL, and optionally create a Neon API key for automation.

Researched · not yet run liveLast researched 25 October 2026 · Neon · provider site

Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.
Do this with verapliJSON for agents

Who owns what

A Neon user can belong to organizations; projects hold branches, computes, databases and roles.

  • Neon user personal owned by the person
  • Organization organisation · under Neon user
  • Project project

Steps

Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.

  1. Create or sign in to a Neon account

    The person signs up or signs in at the Neon Console. verapli never creates the account.

    • Guided by hand
    • Human step: You press submit

    Where: https://console.neon.tech/signup

  2. Create the project

    Click New Project, enter a name, pick the Region (which also fixes the cloud provider) close to the app, set the Postgres version, and create the project.

    • verapli co-pilot
    • Human step: You press submit
    • After: Create or sign in to a Neon account

    Where: https://console.neon.tech/app/projects

  3. Copy the connection string

    Click Connect, choose branch, database and role, keep pooling on (default) and copy the connection string, which includes the password, into DATABASE_URL.

    • verapli co-pilot
    • After: Create the project

    verapli captures DATABASE_URL here by plain code: encrypted in your browser, never shown to AI.

    Where: https://console.neon.tech/app/projects

  4. Create a Neon API key (optional)optional

    For automation, open Settings, API keys (personal in the profile menu, organization or project-scoped in the organization) and create a key. It is shown once; verapli captures it into NEON_API_KEY.

    • Guided by hand
    • Human step: You press submit
    • After: Create or sign in to a Neon account

Terms and gotchas

Plain-English summary, not legal advice. Each card links its source.

Worth knowingThe rules say

On Free, computes scale to zero after 5 minutes idle and this cannot be disabled, so the first query after idle is slower; storage is 1 GB per project. [4]

Worth knowingThe rules say

Project-scoped API keys limit blast radius; personal keys reach every organization project the user belongs to. [3]

What you end up with

Env varSecretFormatWhat it is
DATABASE_URLsecretpostgresql://<role>:<password>@<hostname>/<database>?sslmode=requirePostgres connection string (role, password, host, database); pooled host has -pooler.
NEON_API_KEYsecretNeon API key (Bearer) for the Neon API and CLI.

Pricing

  • Free tier: 100 projects, 10 branches each, 1 GB storage per project (20 GB total), 100 CU-hours per project per month.

Source [4]

For agents

The same entry as JSON: /api/v1/entries/neon/postgres · requirements /api/v1/requirements/neon/postgres · terms /api/v1/terms/neon/postgres.

Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp

> "What do I need for Neon serverless Postgres, and how long will it take?"
  → tools/call requirements { "provider_id": "neon/postgres" }

Sources

  1. Manage projects Console New Project with project name (64 chars), Region (cloud provider is part of the region), Postgres version, Create project; project ID is permanent. · accessed 25 October 2026 · official
  2. Connect from any application Connect button opens the connection modal; pooled is default (-pooler hostname); most frameworks read DATABASE_URL; format postgresql://<role>:<password>@<hostname>/<database>?sslmode=require. · accessed 25 October 2026 · official
  3. Manage API keys Personal, organization and project-scoped API keys; created under Settings, API keys; secret shown once; docs use NEON_API_KEY. · accessed 25 October 2026 · official
  4. Neon plans Free plan 100 projects, 10 branches per project, 1 GB per project (20 GB total), 100 CU-hours per project per month, scale to zero after 5 minutes that cannot be disabled on Free. · accessed 25 October 2026 · official
  5. Stripe Projects provider catalogue Neon is listed in the Stripe Projects catalogue as neon/postgres (Database, Auth). · accessed 25 October 2026 · official

Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Neon is not affiliated with verapli.