How to Use the Neon (Serverless PostgreSQL) MCP in Claude Code

Q: Is it possible to manage Neon (Serverless PostgreSQL) roles from the command line with Claude Code?

Yes. The listroles tool is available through the MCP Server. You can build scripts to audit roles or check permissions as part of your deployment or security validation process.

Hook instant PostgreSQL branching directly into your CI/CD pipeline using Claude Code and the Neon MCP Server. Automation for pros.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Neon (Serverless PostgreSQL) MCP to Claude Code

Create your Vinkius account to connect Neon (Serverless PostgreSQL) to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Neon (Serverless PostgreSQL) with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Database Branching Inside Your Pipeline

On every single pull request, your CI/CD job can call Claude Code to run `create_branch`. This command hits the Neon API and spins up a bit-for-bit, zero-copy clone of your production database. The whole process takes a few seconds. Your integration tests now run against a perfect, isolated, and fresh copy of your production data. No more flaky tests from a contaminated shared staging environment. This is how you get reliable test runs.

Headless Infrastructure Auditing

Write simple shell scripts that use Claude Code to query your entire Neon footprint. You can pipe the JSON output of `list_projects`, `list_branches`, and `list_endpoints` directly to tools like `jq` for quick analysis or logging. Set up a cron job to run your script every hour. It can check for orphaned branches with active compute endpoints, helping you find and eliminate wasted spend before it becomes a problem. This MCP Server is built for exactly this kind of automation.

Fully Ephemeral Environments

Use Claude Code to automate the entire lifecycle of your preview environments. A GitHub Action can trigger a script that calls `create_project` and `create_branch` the moment a PR is opened. Your team gets a unique URL with a fully populated database for testing. When the PR is merged or closed, another webhook triggers a second script. This one calls `delete_project`, and the entire environment—database, data, and all—is wiped completely. No manual cleanup required.

Setup guide

Set up Neon (Serverless PostgreSQL) MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see neon-serverless-postgresql-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Neon (Serverless PostgreSQL) transactions." It will automatically discover and invoke the available Neon (Serverless PostgreSQL) tools.

Terminal

claude mcp add --transport http neon-serverless-postgresql-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Neon (Serverless PostgreSQL) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "neon-serverless-postgresql-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Neon. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Neon (Serverless PostgreSQL) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Neon (Serverless PostgreSQL) MCP in Claude Code

First, add your Vinkius endpoint URL as a secret in GitHub. In your workflow YAML, you'll run `claude mcp add ...` using the secret, then you can call Neon tools like `claude tool:run neon-serverless-postgresql-mcp/create_branch`.

Yes, that's what it's for. The tools output clean JSON. You can run `claude tool:run neon-serverless-postgresql-mcp/list_branches --project-id=... | jq '.result[0].id'` to extract a branch ID and use it in another command.

You add the Vinkius MCP Server URL and its token to your Claude Code config once. Claude Code handles the secure connection, so your scripts only need to know the tool name, not the credentials.

Yes. The `list_roles` tool is available through the MCP Server. You can build scripts to audit roles or check permissions as part of your deployment or security validation process.

Your scripts and CI logs will handle metadata strings from your Neon account. This includes project and branch names, endpoint URLs, and database role identifiers. The connection is TLS-encrypted, but the output will be visible in your runner's logs, so manage access accordingly.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript