Connect Neon MCP to your AI agent
Manage Neon projects, branches, databases, and development workflows.
We set up the connection using your own Neon MCP account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in Neon MCP
Each one is a real action the agent can take on its own, the same things a person clicking around Neon MCP could do. Read-only by default; write actions are confirmed against your policy.
- Compare database schema <use_case> Use this tool to compare the schema of a database between two branches. The output of the tool is a JSON object with one field: `diff`. <example> ```json { "diff": "--- a/neondb +++ b/neondb @@ -27,7 +27,10 @…
- Complete database migration Complete a database migration by applying changes to the main branch and cleaning up the temporary branch. NEVER run autonomously; always ask the user first and verify in the temporary branch. <important_notes> You MUST…
- Complete query tuning Complete a query tuning session by either applying the changes to the main branch or discarding them. NEVER run autonomously; always ask the user first and verify on the temporary branch. <important_notes> BEFORE RUNNIN…
- Configure neon auth Configure Neon Auth for a branch by specifying an `operation`. NEVER run autonomously; always ask the user first. Do not use to provision for the first time (use `provision_neon_auth` instead) or to read current config…
- Create branch Create a branch in a Neon project for isolated development or testing. By default the branch is created from the project's default branch; pass `parentId` to fork an existing non-default branch instead (e.g. to make a d…
- Create project Create a new Neon project with a default database and branch. If someone is trying to create a database, use this tool. Returns a connection string for the new project automatically. Supports optional `org_id` (assign t…
- Delete branch Delete a branch and all its data. NEVER run autonomously; always ask the user first. For deleting an entire project, use `delete_project` instead. <notice> Notice: Write mode active. Destructive tools are exposed. For t…
- Delete project Delete a Neon project and all its data. NEVER run autonomously; always ask the user first. For removing single branches, use `delete_branch` instead. <notice> Notice: Write mode active. Destructive tools are exposed. Fo…
- Describe branch Get a tree view of all objects in a branch, including databases, schemas, tables, views, and functions. Do not use when you only need table names (use `get_database_tables` instead) or column detail (use `describe_table…
- Describe project Get details and configuration of a specific Neon project. Do not use when you need to list all projects (use `list_projects` instead). <notice> Notice: Write mode active. Destructive tools are exposed. For tools with `d…
- Describe table schema Get column definitions, data types, and constraints for a specific table. Do not use when you need all tables in a database (use `get_database_tables` instead). <notice> Notice: Write mode active. Destructive tools are…
- Explain sql statement Analyze the query execution plan for a SQL statement using EXPLAIN ANALYZE. Do not use when you need to execute the query for results (use `run_sql` instead). <notice> Notice: Write mode active. Destructive tools are ex…
- Fetch Fetch detailed information about a specific organization, project, or branch using the ID returned by the `search` tool. <notice> Notice: Write mode active. Destructive tools are exposed. For tools with `destructiveHint…
- Get connection string Get a PostgreSQL connection string for a Neon database. All parameters are optional; the tool resolves the project, branch, and database automatically if not specified. Requires write access: the connection string carri…
- Get database tables List all tables in a Neon database. Do not use when you need column-level detail for a specific table (use `describe_table_schema` instead). <notice> Notice: Write mode active. Destructive tools are exposed. For tools w…
- Get doc resource <use_case> Fetches a specific Neon documentation page as markdown content. Use the list_docs_resources tool first to discover available page slugs, then pass the slug to this tool. Use this tool when: - You have identif…
- Get neon auth config Read full Neon Auth configuration for a branch. Do not use when you need to update config (use `configure_neon_auth` instead). Requires Neon Auth to be provisioned first (use `provision_neon_auth`). Returns Neon Auth (B…
- Inspect database <use_case> Reach for this first when asked why a database is slow, large, bloated, or behind. It runs one predefined, read-only Postgres diagnostic against a Neon branch — pick the one that answers the question from the…
- List branch computes List compute endpoints for a project or branch. Do not use when you need a connection string: use `get_connection_string`, which requires write access and is unavailable in read-only mode. <notice> Notice: Write mode ac…
- List docs resources <use_case> Lists all available Neon documentation pages by fetching the index from https://neon.com/docs/llms.txt. Returns a markdown index of documentation page URLs (with .md file endings) and titles that can be fetch…
- List log fields List the log fields whose values list_log_field_values can enumerate for a branch. The endpoint currently returns `service_name`, `severity_text`, `scope_name`, and `entity_type`. Call this tool instead of hardcoding th…
- List log field values List the distinct values of a log field (e.g. all service_name or severity_text values seen) within a branch and time window. Use values with the corresponding query_logs structured input when one exists, or with raw lo…
- List organizations List all organizations the current user belongs to. Supports optional `search` parameter to filter by name or ID. <notice> Notice: Write mode active. Destructive tools are exposed. For tools with `destructiveHint: true`…
- List projects List Neon projects in your account. Do not use for projects shared with you (use `list_shared_projects` instead). Supports optional `search` (filter by name or ID) and `limit` (default 10) parameters. <notice> Notice: W…
- List shared projects List projects shared with the current user for collaboration. Do not use for projects you own (use `list_projects` instead). Supports optional `search` (filter by name or ID) and `limit` (default 10) parameters. <notice…
- List slow queries <use_case> Use this tool to list slow queries from your Neon database. </use_case> <important_notes> This tool queries the pg_stat_statements extension to find queries that are taking longer than expected. The tool will…
- Prepare database migration <use_case> This tool performs database schema migrations by automatically generating and executing DDL statements. Supported operations: CREATE operations: - Add new columns (e.g., "Add email column to users table") - C…
- Prepare query tuning <use_case> This tool helps developers improve PostgreSQL query performance for slow queries or DML statements by analyzing execution plans and suggesting optimizations. The tool will: 1. Create a temporary branch for te…
- Provision neon auth Provisions Neon Auth for a Neon branch. Neon Auth is a managed authentication service built on Better Auth, fully integrated with Lakebase Postgres and the rest of the Neon backend primitives. <workflow> The tool will:…
- Provision neon data api Provisions the Neon Data API for a Neon branch. The Data API enables HTTP-based access to your Postgres database with automatic JWT authentication support. <interactive_behavior> When called WITHOUT an authProvider: 1.…
- Query logs <use_case> Query logs emitted by your Neon serverless functions (and other services like storage). Logs are OpenTelemetry-based; this tool exposes them through structured filters so you don't have to write a query langu…
- Reset from parent Reset a branch to its parent's current state, discarding all changes made on the branch. NEVER run autonomously; always ask the user first. Use `preserveUnderName` to preserve the current state under a new branch name b…
- Run sql <use_case> Use this tool to execute a single SQL statement against a Neon database. </use_case> <important_notes> If you have a temporary branch from a prior step, you MUST: 1. Pass the branch ID to this tool unless exp…
- Run sql transaction <use_case> Use this tool to execute a SQL transaction against a Neon database, should be used for multiple SQL statements. </use_case> <important_notes> If you have a temporary branch from a prior step, you MUST: 1. Pas…
- Search Search across all organizations, projects, and branches by keyword. Returns matching items with id, title, and URL. Query must be at least 3 characters. Do not use when you need all projects (use `list_projects` instead…
Setup
How we connect it
- 1
Connect your account
You log in with your own Neon MCP account. We never see your password, and you can revoke access from Neon MCP at any time.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Neon MCP questions, answered.
You sign in with your own Neon MCP account. Permissions are scoped to the minimum the agent needs, the connection is health-checked, and you can revoke access from Neon MCP at any time.
The actions Neon MCP's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put Neon MCP to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Neon MCP.