Neon MCP Server

Neon MCP Server is an intelligent database interaction service officially launched by the Neon team. Built on the Model Context Protocol (MCP) and deployed on Vercel, it serves as a bridge between LLMs and Neon Postgres, automatically converting natural language instructions into API calls and eliminating the need to write SQL manually.

In terms of core capabilities, it covers the full database lifecycle management, including the creation and deletion of projects and branches, SQL read/write execution, and in-depth schema exploration. For high-risk operations, the service builds in safe migration and performance tuning workflows, ensuring primary database security through a temporary branching mechanism. It also integrates one-click provisioning for Neon Auth and Data API, along with official documentation retrieval capabilities.

Architecturally, the service is built with Next.js App Router, supporting both Streamable HTTP (recommended) and SSE transport protocols. Its security model is finely grained, allowing instant switching of read-only mode, project scoping, and tool category filtering via URL parameters, combined with a complete OAuth 2.0 loop from authorization to revocation. Open-sourced under the MIT license, the service is currently targeted at local development and AI IDE integration scenarios, with support for mainstream clients like Cursor, VS Code, and Claude Code.

Quick Start#

The project focuses on a remote hosted mode requiring no local installation, with three onboarding paths:

One-click init (for Cursor / VS Code / Claude Code):

npx neonctl@latest init

Remote server + OAuth (recommended):

npx add-mcp https://mcp.neon.tech/mcp

Remote server + API Key:

npx add-mcp https://mcp.neon.tech/mcp --header "Authorization: Bearer <$NEON_API_KEY>"

MCP client config example (OAuth):

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

Dynamic Configuration#

Control behavior in real time via URL Query String without re-authentication:

• readonly: Boolean, enable read-only mode
• projectId: String, restrict operations to a specific project
• category: String, limit tool categories (multiple allowed, e.g. querying, schema)

A /api/list-tools endpoint is available for previewing visible MCP tools under the current configuration.

Security & Permissions#

• Read-only mode: Disable all write operations via ?readonly=true or OAuth scope
• Project-level isolation: Restrict operations to a single project via ?projectId=proj-123
• Tool category filtering: Limit the tool set exposed to the LLM via ?category=
• OAuth Scopes: Three permission levels supported: read, write, *

Unconfirmed Information#

• Current version number and release cadence are not explicitly stated in the README
• Full local self-hosting support is not clearly documented
• SLA for the remote service mcp.neon.tech is not mentioned in the repository