Stuck on an error with Neon? GET https://mcp.kansei-link.com/api/v1/ask?service=neon-db&error=<short message> returns any checked fixes on file and the official docs. Read-only; nothing is published. Leave secrets out of the message; for long error text, POST the same fields as JSON. Solved it, or not? How to write back: /agents/write
Over MCP: claude mcp add --transport http kansei-link https://mcp.kansei-link.com/mcp then lookup({ service_id: "neon-db" }) (no key; offline: npx -y @kansei-link/mcp-server)
Remote (recommended): claude mcp add --transport http neon [remote-mcp-url]. Browser OAuth flow on first use. Local: 1. Get API key from console.neon.tech/settings/api-keys. 2. claude mcp add neon -- npx -y @neondatabase/mcp-server-neon (set NEON_API_KEY env).
| Base URL | https://console.neon.tech/api/v2/ (control plane) + postgres:// connection strings (data plane) |
|---|---|
| API version | v2 (control plane) |
| Auth | Two modes: (1) Remote managed MCP with OAuth (recommended, no API key management) or (2) Local with Neon API key (NEON_API_KEY env var, generated at console.neon.tech/settings/api-keys). |
| Scopes | Account-level (API keys currently grant full account access). |
| Request body | application/json |
| Pagination | Cursor-based: `limit` + `cursor` query params for list endpoints. |
| Rate limit | Control plane: 700 requests/minute per API key. Data plane: bound by compute size (Free tier: 0.25 CU = ~100 connections via pooled URL). |
| Error format | JSON: {"code":"...","message":"..."} for control plane. Standard PostgreSQL errors for data plane. |
| Method | Path | Description |
|---|---|---|
POST | /projects | Create a Neon project (creates a primary branch and compute) |
GET | /projects/{project_id}/branches | List branches (Neon supports Git-like DB branching) |
POST | /projects/{project_id}/branches | Create a new branch from an existing branch |
GET | /projects/{project_id}/endpoints | List compute endpoints for a project |
POST | /projects/{project_id}/databases | Create a database within a project |
GET https://console.neon.tech/api/v2/projects
Authorization: Bearer {neon_api_key}
Response: {"projects":[{"id":"quiet-snowflake-123","name":"My App","region_id":"aws-us-east-1","created_at":"..."}]}Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-06-08. Specs change — verify against the official docs before production use.