neon
Use when working with Neon serverless Postgres — project setup, branching,
| Model | Source |
|---|---|
| sonnet | pack: database |
Full Reference
┏━ 🔧 neon ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when working with Neon serverless Postgres… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
Neon is a serverless Postgres platform with copy-on-write branching and scale-to-zero compute. Instant database branches — full clones in milliseconds, zero impact on the parent.
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| API Base | https://console.neon.tech/api/v2/ |
| Auth | Bearer token (Authorization: Bearer $NEON_API_KEY) |
| MCP Server | https://mcp.neon.tech/mcp |
| Node.js Driver | @neondatabase/serverless (v1.0.2, Node.js 19+) |
| AI Toolkit | @neondatabase/toolkit |
| Rate Limits | 700 req/min; burst 40 req/sec per route; HTTP 429 on exceed |
| Docs | https://neon.com/docs |
Reference Index
Section titled “Reference Index”| Topic | File | When to use |
|---|---|---|
| MCP server setup | reference/mcp-setup.md | Setting up Neon MCP in Claude Code or any MCP client |
| Auth, API keys, connection strings | reference/auth-and-connections.md | Connecting to Neon, environment variables, direct vs pooled |
Serverless driver (@neondatabase/serverless) | reference/serverless-driver.md | HTTP mode, WebSocket mode, ORM integration, Node.js setup |
| REST API (projects, branches, endpoints) | reference/api-reference.md | Programmatic project/branch/compute management |
| Branching workflows | reference/branching.md | Per-PR branches, point-in-time restore, branch limits |
| Connection pooling (PgBouncer) | reference/connection-pooling.md | Pooled vs direct, transaction mode limitations |
| Autoscaling and compute sizing | reference/autoscaling-and-compute.md | CU sizing, scale-to-zero, cold starts, LFC |
| Pricing tiers | reference/pricing.md | Free vs Launch vs Scale, billing model |
| Error codes | reference/error-codes.md | HTTP errors, connection errors, branch errors |
| SDKs and CLI (neonctl) | reference/sdks-and-cli.md | TypeScript, Python, Go SDKs; neonctl commands |
| GitHub Actions | reference/github-actions.md | PR preview branches, schema diff, CI/CD patterns |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.