---
title: Neon | Keycard
description: Serverless Postgres with branching and autoscaling
---

Manage Neon Postgres databases directly from your AI assistant. Create and manage database branches, run SQL queries, manage roles and permissions, and monitor database performance without leaving your coding environment.

Adding Neon provisions three things in your zone: an upstream resource pointing at `https://mcp.neon.tech/mcp` (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Neon’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Neon token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s [identity provider](/admin/identity-providers/index.md), [access policies](/admin/access-policies/index.md), and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

## Tools

TOOLS

Tools the upstream server exposes through the Keycard MCP Gateway.

Neon exposes 29 tools through the gateway:

- list\_projects

  Lists Neon projects with pagination and optional search filters

- list\_shared\_projects

  List Neon projects shared with current user

- describe\_project

  Get detailed metadata for a Neon project

- Create a new Neon project

  Creates a new Neon project

- Delete a Neon project

  Deletes a Neon project

- list\_organizations

  List accessible organizations with filters

- create\_branch

  Create a new branch in a Neon project

- delete\_branch

  Delete a branch from a Neon project

- describe\_branch

  Get branch tree: databases, schemas, tables, views

- list\_branch\_computes

  List compute endpoints for a project or branch

- compare\_database\_schema

  Diff branch schema against parent with migration plan

- reset\_from\_parent

  Reset a branch to match its parent state

- get\_connection\_string

  Generate a PostgreSQL connection string

- run\_sql

  Run a single SQL statement on a Neon database

- run\_sql\_transaction

  Run multiple SQL statements as a transaction

- get\_database\_tables

  List all tables in a Neon database

- describe\_table\_schema

  Get table schema details in a Neon database

- prepare\_database\_migration

  Validate migration SQL on a temporary branch

- complete\_database\_migration

  Apply approved migration and clean up temp branch

- provision\_neon\_auth

  Set up Neon Auth for a branch

- provision\_neon\_data\_api

  Set up Neon Data API for a branch

- explain\_sql\_statement

  Run EXPLAIN or EXPLAIN ANALYZE on a SQL statement

- prepare\_query\_tuning

  Analyze query performance and propose optimizations

- complete\_query\_tuning

  Apply or discard query tuning changes

- list\_slow\_queries

  List slow queries from pg\_stat\_statements

- search

  Search across content in the workspace

- fetch

  Get any object by its ID

- list\_docs\_resources

  List available Neon documentation pages

- get\_doc\_resource

  Get a Neon doc page as markdown by slug

Show all 29 tools  Show fewer

## Install

INSTALL

Add Neon to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

1. **Open the catalog**

   In your zone’s [Keycard Console](https://console.keycard.ai), go to **Applications** → **Add Application** → **Explore MCP Servers**.

2. **Find and install Neon**

   Search for `Neon` in the catalog and click **Install**.

3. **Connect your development tool**

   Once installed, Neon appears on the **Applications** page with a **Keycard MCP Gateway URL**. Use the **Install** dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.

## Related

RELATED

- [Catalog overview](/admin/catalog/index.md) - browse other MCP and API servers
- [Access policies](/admin/access-policies/index.md) - control who can use Neon
- [Identity providers](/admin/identity-providers/index.md) - control who can sign in

[PreviousMonday.com](/admin/catalog/mcp-servers/monday/index.md)[NextNotion](/admin/catalog/mcp-servers/notion/index.md)
