Skip to content
API Reference
Admin /Catalog /MCP Servers
Neon logo

Neon

Developer Tools

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, access policies, 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

Section titled “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

Install

Section titled “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, 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.

Section titled “Related”
RELATED