Skip to main content
Neon MCP logo
  • Category: databases
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 104
  • Triggers: 0
  • Slug: NEON_MCP
  • Version: 20261018_00

Tools

Slug: NEON_MCP_ADD_AUTH_OAUTH_PROVIDERAdds an OAuth provider configuration to the specified branch’s Neon Auth integration.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string ("google" | "github" | "microsoft" | "vercel")
required
string
required
string
string
required
string
string
Slug: NEON_MCP_ADD_AUTH_TRUSTED_DOMAINAdds a domain to the redirect URI whitelist for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string ("mock" | "stack" | "better_auth")
required
Slug: NEON_MCP_COMPARE_DATABASE_SCHEMACompare one database’s SQL schema on a branch to another. database_name is required. Omit base_branch_id to compare against the parent; it is a branch id (br-...), not a name. Pass lsn, timestamp, base_lsn, or base_timestamp only for a point-in-time comparison.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
string
string
required
string
string
required
string
required
string
string
Slug: NEON_MCP_COMPLETE_DATABASE_MIGRATIONApply or discard a prepared migration and delete the temporary branch. NEVER run autonomously; always ask the user first. Pass migration_id, migration_sql, database_name, project_id, temporary_branch_id, and parent_branch_id from prepare_database_migration. Set apply_changes false to discard; omitting it applies the migration.

Input Parameters

string
required
The project ID. Pass the exact value from prepare_database_migration.
string
required
The migration ID from prepare_database_migration.
boolean
Whether to apply the migration. Set to false to just delete the temp branch without applying.
string
required
The database name. Pass the exact value from prepare_database_migration.
string
required
The SQL statements to apply. Pass the exact value from prepare_database_migration.
string
required
The parent branch ID where migration will be applied.
string
required
The temporary branch ID to delete after migration.
Slug: NEON_MCP_COMPLETE_QUERY_TUNINGApply or discard query-tuning changes and delete the temporary branch. NEVER run autonomously. Before calling, apply suggested SQL with run_sql on the temporary branch and re-run explain_sql_statement. Pass the tuning_id from prepare_query_tuning, not the branch id, plus temporary_branch_id. Set apply_changes true to apply; omitting it discards. Call this even when the user rejects the changes. Do not use prepare_database_migration.

Input Parameters

string
The ID or name of the branch that receives the changes. If not provided, the default (main) branch will be used.
string
The name of the role to connect with. If you have used a specific role in prepare_query_tuning you MUST pass the same role again to this tool. If not provided, the default role (usually “neondb_owner”) will be used.
string
required
The ID of the tuning to complete. This is NOT the branch ID. Remember this ID from the prior step using tool prepare_query_tuning.
string
required
The ID of the project to execute the query against
boolean
Whether to apply the suggested changes to the main branch
string
required
The name of the database to execute the query against
string
required
The ID of the temporary branch that needs to be deleted after tuning.
array
required
The SQL DDL statements to execute to improve performance. These statements are the result of the prior steps, for example creating additional indexes.
boolean
Whether to delete the temporary branch after tuning
Slug: NEON_MCP_CREATE_AUTH_USERCreates a new user in the Neon Auth user directory for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
string
required
string
required
string
required
Slug: NEON_MCP_CREATE_BRANCHCreates a branch with a read-write compute and waits until it is ready. Pass no_compute: true to skip the endpoint. Does not return a connection string; call get_connection_string with the project and branch id. Copies the parent at HEAD; point-in-time restore is restore_snapshot.

Input Parameters

string
object
string
boolean
Skip the read-write endpoint. Default false. Cannot be combined with compute.
string
required
Slug: NEON_MCP_CREATE_POSTGRES_DATABASECreates a database in the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string
required
Slug: NEON_MCP_CREATE_POSTGRES_ENDPOINTCreates a compute endpoint on a branch. Does not return a connection string; call get_connection_string.

Input Parameters

string
string ("read_only" | "read_write")
required
boolean
object
string
required
string
string
required
string ("transaction")
string
boolean
boolean
integer
number
number
Slug: NEON_MCP_CREATE_POSTGRES_ROLECreates a Postgres role in the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
boolean
string
required
string
required
Slug: NEON_MCP_CREATE_PROJECTCreates a Neon project and waits until the default compute is ready. Pass org_id with a personal API key. Does not return a connection string; call get_connection_string with the project id.

Input Parameters

string
object
string
object
string
integer
string
boolean
number
number
object
integer
Slug: NEON_MCP_CREATE_SNAPSHOTCreates a snapshot from the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
string
string
required
string
string
string
required
Slug: NEON_MCP_CREATE_STORAGE_BUCKETCreates a new branchable object storage bucket on the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string ("private" | "public_read")
Slug: NEON_MCP_DELETE_AUTH_OAUTH_PROVIDERDeletes an OAuth provider from the specified project.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string ("google" | "github" | "microsoft" | "vercel")
required
Slug: NEON_MCP_DELETE_AUTH_TRUSTED_DOMAINRemoves a domain from the redirect URI whitelist for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

array
required
string
required
string
required
string ("mock" | "stack" | "better_auth")
required
Slug: NEON_MCP_DELETE_AUTH_USERDeletes the specified user from the Neon Auth user directory for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_BRANCHDelete a branch and all its data. NEVER run autonomously; always ask the user first. For the whole project, use delete_project.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_DELETE_DATA_APIDeletes the Neon Data API for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_FUNCTIONDeletes the function identified by its slug.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_FUNCTIONS_CUSTOM_DOMAINRemoves a custom domain registered on the branch and stops routing it.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_POSTGRES_DATABASEDeletes the specified database from the branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_POSTGRES_ENDPOINTDeletes the specified compute endpoint.

Input Parameters

string
required
string
required
Slug: NEON_MCP_DELETE_POSTGRES_ROLEDeletes the specified Postgres role from the branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_PROJECTDelete a Neon project and all its data. NEVER run autonomously; always ask the user first. For a single branch, use delete_branch.

Input Parameters

string
required
Slug: NEON_MCP_DELETE_SNAPSHOTDeletes the specified snapshot.

Input Parameters

string
required
string
required
Slug: NEON_MCP_DELETE_STORAGE_BUCKETDeletes the named bucket from the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_DELETE_STORAGE_OBJECTDeletes the named object from the bucket on the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string
required
Slug: NEON_MCP_DELETE_STORAGE_OBJECTS_BY_PREFIXSoft-deletes every object on the specified branch whose key starts with prefix, in a single call.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string
required
Slug: NEON_MCP_DEPLOY_FUNCTIONCreates a deployment for the function. Supply at least one of zip, environment, or runtime; omitted fields inherit the latest version. The first deployment must include zip.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
Base64-encoded binary file contents.
string
required
string ("nodejs24")
string
required
string
required
string
Slug: NEON_MCP_DESCRIBE_BRANCHGet 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_schema instead).

Input Parameters

string
required
An ID of the branch to describe
string
required
The ID of the project
string
The name of the database. If not provided, the default neondb or first available database is used.
Slug: NEON_MCP_DESCRIBE_PROJECTRetrieves the project record (settings, compute, usage). Call list_branches for branches.

Input Parameters

string
required
Slug: NEON_MCP_DESCRIBE_TABLE_SCHEMAGet 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).

Input Parameters

string
An optional ID of the branch to execute the query against. If not provided the default branch is used.
string
required
The ID of the project to execute the query against
string
required
The table name, optionally schema-qualified (for example, crm.contacts)
string
The name of the database. If not provided, the default neondb or first available database is used.
Slug: NEON_MCP_DISABLE_AUTHDisables the Neon Auth integration for the specified branch, removing the connection to the authentication provider.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
boolean
Slug: NEON_MCP_EXPLAIN_SQL_STATEMENTAnalyze 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).

Input Parameters

string
required
The SQL statement to analyze
boolean
Whether to include ANALYZE in the EXPLAIN command
string
An optional ID of the branch to execute the query against. If not provided the default branch is used.
string
required
The ID of the project to execute the query against
string
The name of the database. If not provided, the default neondb or first available database is used.
Slug: NEON_MCP_FETCHFetch detailed information about a specific organization, project, or branch using the ID returned by the search tool.

Input Parameters

string
required
The ID returned by the search tool to fetch detailed information about the entity
Slug: NEON_MCP_FINALIZE_BRANCH_RESTOREFinalize a branch created with restore_snapshot and finalize: false: reassign computes (this restarts them) and swap names so it replaces the original branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
string
required
string
required
Slug: NEON_MCP_GET_AI_GATEWAYReturns the AI Gateway endpoint host for the specified branch, used to render code-snippet base URLs.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_GET_AUTHRetrieves the Neon Auth integration details for the specified branch, including the auth provider type and integration status.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_GET_BRANCHRetrieves information about the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_GET_CONNECTION_STRINGGet a PostgreSQL connection string for a Neon database. The branch must have a compute endpoint. create_project and create_branch do not return one; call this after they succeed. All parameters are optional; the tool resolves the project, branch, and database automatically if not specified. Requires write access: the connection string carries a privileged role password, so it is unavailable in read-only mode. A read-only caller who needs a DATABASE_URL must copy it from https://console.neon.tech manually.

Input Parameters

string
The ID or name of the branch. If not provided, the default branch will be used.
string
The name of the role to connect with. If not provided, the database owner name will be used.
string
The ID of the compute/endpoint. If not provided, the read-write compute associated with the branch will be used.
string
required
The ID of the project. If not provided, the only available project will be used.
string
The name of the database. If not provided, the default neondb or first available database is used.
Slug: NEON_MCP_GET_DATA_APIRetrieves the Neon Data API configuration for the specified branch, including endpoint URL, enabled state, and database settings.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_GET_DATABASE_TABLESList all tables in a Neon database. Do not use when you need column-level detail for a specific table (use describe_table_schema instead).

Input Parameters

string
An optional ID of the branch. If not provided the default branch is used.
string
required
The ID of the project
string
The name of the database. If not provided, the default neondb or first available database is used.
Slug: NEON_MCP_GET_DEFAULT_BRANCHResolve the project’s default branch by the default flag, not by name.

Input Parameters

string
required
Slug: NEON_MCP_GET_DOC_RESOURCEFetch one Neon documentation page as markdown. Pass a slug from list_docs_resources (for example docs/guides/prisma.md).

Input Parameters

string
required
The docs page slug (path) to fetch, e.g. ‘docs/guides/prisma.md’. Slugs use .md file endings matching the URLs in the documentation index. Use the list_docs_resources tool first to discover available slugs.
Slug: NEON_MCP_GET_FUNCTIONReturns the function identified by its slug.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_GET_NEON_AUTH_CONFIGRead Neon Auth config for a branch with OAuth and SMTP secrets redacted as “redacted”. Requires provision_neon_auth first.

Input Parameters

string
Branch ID. If omitted, the project default branch is used (same as provision_neon_auth).
string
required
Neon project ID
Slug: NEON_MCP_GET_OPERATIONRetrieves details for the specified operation.

Input Parameters

string
required
string
required
Slug: NEON_MCP_GET_POSTGRES_DATABASERetrieves information about the specified database.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_GET_POSTGRES_ENDPOINTRetrieves information about the specified compute endpoint.

Input Parameters

string
required
string
required
Slug: NEON_MCP_GET_POSTGRES_ROLERetrieves details about the specified role.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_GET_SNAPSHOT_SCHEDULEReturns the backup schedule for the specified branch, including the configured snapshot frequencies.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_GET_STORAGEReturns whether branchable object storage is usable for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_INSPECT_DATABASERun one read-only neon inspect db check (pick check from the input schema). Not for arbitrary SQL (run_sql), one statement’s plan (explain_sql_statement), or applying indexes (prepare_query_tuning). Omit database_name to cover every database; some checks are compute-wide. If a check needs an extension, the tool names CREATE EXTENSION; ask before running it.

Input Parameters

string ("table-sizes" | "index-sizes" | "unused-indexes" | "seq-scans" | "long-running-queries" | "stalled-queries" | "locks" | "outliers" | "calls" | "lfc-hit-rate" | "working-set" | "vacuum-stats" | "bloat" | "replication-slots" | "subscriptions")
required
Which diagnostic to run: table-sizes: Size of each table (including TOAST), largest first (pg_table_size) index-sizes: Size of each index, largest first (pg_relation_size) unused-indexes: Non-unique indexes with fewer than 50 scans — candidates for removal (pg_stat_user_indexes) seq-scans: Number of sequential scans recorded against each table (pg_stat_user_tables) long-running-queries: Queries running longer than 5 minutes (pg_stat_activity) stalled-queries: Active queries running longer than 30 seconds with parallel-worker grouping, waits, and blockers, oldest query group first (compute-wide) locks: Locks held with the acquiring query and its age (pg_locks + pg_stat_activity) outliers: The 25 queries with the highest cumulative execution time since statistics were last reset (needs pg_stat_statements) calls: The 25 most frequently executed queries since statistics were last reset (needs pg_stat_statements) lfc-hit-rate: Local File Cache hit rate (compute-wide, needs neon extension) working-set: Estimated working set vs LFC size (compute-wide, needs neon extension) vacuum-stats: Autovacuum status per table: last (auto)vacuum, dead tuples, threshold bloat: Estimated bloat for the 25 most bloated tables (statistical estimate, no extension needed) replication-slots: Replication slots (compute-wide): kind, status, client, restart/confirmed-flush LSNs, and lag (pg_replication_slots + pg_stat_replication) subscriptions: Per-table logical replication progress on this subscriber (pg_subscription_rel)
integer
Maximum number of rows to return from the combined result. Per-database ranking and SQL caps are applied first. The response reports how many rows the check produced and whether they were truncated, so raise this only when truncated is true. A few checks are capped in SQL and say so in their description.
string
An optional ID of the branch. If not provided the default branch is used.
string
The ID of the compute/endpoint. If not provided, the read-write compute associated with the branch will be used.
string
required
The ID of the project to inspect
string
For a database-scoped check, the database to inspect. Omit to cover every database on the branch. Ranking and SQL row limits stay per database. One failing database fails the whole run. For a compute-wide check, the database to connect through; the check still runs once for the whole compute and the result does not include databaseName. The response limit applies to the combined rows after that.
Slug: NEON_MCP_LIST_AUTH_OAUTH_PROVIDERSLists the OAuth providers configured for the specified branch’s Neon Auth integration.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_AUTH_TRUSTED_DOMAINSLists the trusted domains in the redirect URI whitelist for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_BRANCH_COMPUTESRetrieves a list of compute endpoints for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_BRANCHESRetrieves a list of branches for the specified project. Returns every page. Pass limit to cap how many.

Input Parameters

integer
string ("name" | "created_at" | "updated_at")
string
required
string ("asc" | "desc")
boolean
Slug: NEON_MCP_LIST_DOCS_RESOURCESList Neon documentation page slugs from neon.com/docs/llms.txt. Call this before get_doc_resource; do not guess slugs.
Slug: NEON_MCP_LIST_FUNCTIONSLists functions on the specified branch. Returns every page. Pass limit to cap how many.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

integer
string
required
string
required
Slug: NEON_MCP_LIST_FUNCTIONS_CUSTOM_DOMAINSLists all custom domains registered on the branch, across every target entity. Returns every page. Pass limit to cap how many.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

integer
string
required
string
required
Slug: NEON_MCP_LIST_LOG_FIELDSLists the low-cardinality log fields observed on this branch. Call list_log_field_values with field_name to list distinct values.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_LOG_FIELD_VALUESLists distinct values for a low-cardinality log field. Call list_log_fields first for field_name; a field the branch has never emitted returns unknown_field. Pass since or start_time, not both; default is the previous six hours, max seven days. Private beta.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

integer
string
string ("function" | "storage" | "pg_endpoint")
string
string
required
string
required
string
required
string
Slug: NEON_MCP_LIST_OPERATIONSLists operations for a project. Omitting limit returns every remaining page. There is no cursor argument.

Input Parameters

integer
string
required
Slug: NEON_MCP_LIST_ORGANIZATIONSList all organizations the current user belongs to. Supports optional search parameter to filter by name or ID.

Input Parameters

string
Search organizations by name or ID. You can specify partial name or ID values to filter results.
Slug: NEON_MCP_LIST_POSTGRES_DATABASESRetrieves a list of databases for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_POSTGRES_ENDPOINTSRetrieves a list of compute endpoints for the specified project.

Input Parameters

string
required
Slug: NEON_MCP_LIST_POSTGRES_ROLESRetrieves a list of Postgres roles from the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_PROJECT_MEMBERSLists organization members and their per-project roles for an org-owned project. Returns every page. Pass limit to cap how many.

Input Parameters

integer
string
required
Slug: NEON_MCP_LIST_PROJECT_PERMISSIONSRetrieves details about users who have access to the project, including the permission id, the granted-to email address, and the date project access was granted.

Input Parameters

string
required
Slug: NEON_MCP_LIST_PROJECTSList Neon projects you own. Returns every page. Pass limit to cap how many. There is no cursor argument. Pass org_id with a personal API key to list that org’s projects.

Input Parameters

integer
string
string
integer
boolean
Slug: NEON_MCP_LIST_REGIONSLists Neon regions available to the authenticated account.
Slug: NEON_MCP_LIST_SLOW_QUERIESList queries from pg_stat_statements by execution time, slowest first. For sizes, indexes, locks, cache, bloat, or replication use inspect_database.

Input Parameters

number
Maximum number of slow queries to return
string
An optional ID of the branch. If not provided the default branch is used.
string
The ID of the compute/endpoint. If not provided, the read-write compute associated with the branch will be used.
string
required
The ID of the project to list slow queries from
string
The name of the database. If not provided, the default neondb or first available database is used.
number
Minimum execution time in milliseconds to consider a query as slow
Slug: NEON_MCP_LIST_SNAPSHOTSLists the snapshots for the specified project.

Input Parameters

string
required
Slug: NEON_MCP_LIST_STORAGE_BUCKETSLists branchable object storage buckets visible on the specified branch, including those inherited from ancestor branches.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_LIST_STORAGE_OBJECTSLists objects visible in the named bucket on the specified branch, including those inherited from ancestor branches. Returns every page. Pass limit to cap how many.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

integer
string
string
required
string
string
required
string
required
Slug: NEON_MCP_PREPARE_DATABASE_MIGRATIONApply a schema change on a temporary branch and return a migration_id. Test with run_sql on that branch, ask the user, then complete_database_migration — even if they reject, so the temporary branch is deleted. Pass every field from the prepare response.

Input Parameters

string
required
The ID of the project to execute the query against
string
The name of the database. If not provided, the default neondb or first available database is used.
string
required
The SQL to execute to create the migration
Slug: NEON_MCP_PREPARE_QUERY_TUNINGAnalyze a slow query on a temporary branch and return a tuning_id. Apply suggested SQL with run_sql on that branch, re-run explain_sql_statement there, then complete_query_tuning with the tuning_id (not the branch id) — apply_changes true if they accept, omit it or pass false if they reject, so the temporary branch is deleted. Do not use prepare_database_migration.

Input Parameters

string
required
The SQL statement to analyze and tune
string
The name of the role to connect with. If not provided, the default role (usually “neondb_owner”) will be used.
string
required
The ID of the project to execute the query against
string
required
The name of the database to execute the query against
Slug: NEON_MCP_PRESIGN_STORAGE_OBJECTReturns a presigned URL that transfers bytes directly to or from the object’s bucket on the specified branch, without the caller ever handling S3 credentials.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string ("upload" | "download")
required
string
required
string
required
string
required
string
integer
Slug: NEON_MCP_PROVISION_NEON_AUTHEnables Neon Auth for the specified branch by connecting it to an authentication provider.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string ("mock" | "stack" | "better_auth")
required
string
Slug: NEON_MCP_PROVISION_NEON_DATA_APICreates a new instance of Neon Data API in the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
object
string
required
string
required
string
string ("neon_auth" | "external")
string
required
string
boolean
boolean
Slug: NEON_MCP_QUERY_LOGSReturns logs for a branch. Pass limit to cap how many. There is no cursor argument. Filters combine with AND. Pass logql instead of structured filters, not with them. Give the window as since or start_time, not both; default is the previous hour, max seven days; end_time is exclusive. Private beta; a branch without logs access returns HTTP 404 with reason “telemetry_not_enabled”.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

integer
string
string
string ("function" | "storage" | "pg_endpoint")
string
string
string
required
string
required
string
string ("asc" | "desc")
string
string
string
string
string ("trace" | "debug" | "info" | "warn" | "error" | "fatal")
Slug: NEON_MCP_RECOVER_PROJECTRecovers a deleted project within the 7-day deletion recovery period.

Input Parameters

string
required
Slug: NEON_MCP_REGISTER_FUNCTIONS_CUSTOM_DOMAINRegisters a hostname on the branch and routes it to a function. Pass entity_type: "function" and entity_id as the slug from list_functions. Point a CNAME at the returned cname_target.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string
required
string
required
Slug: NEON_MCP_RESET_FROM_PARENTReset a branch to its parent’s current HEAD. Discards every change the branch has written since it diverged. NEVER run autonomously; always ask the user first. preserve_under_name saves the current state first and is required when the branch has children; those children move to the new branch. Point-in-time restore is restore_snapshot.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
Name under which to save the current branch before the reset. Required when the branch has children; those children move to the new branch.
Slug: NEON_MCP_RESET_POSTGRES_ROLE_PASSWORDResets the password for the specified Postgres role.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_RESTART_POSTGRES_ENDPOINTRestarts the specified compute endpoint by immediately suspending it and then starting it again.

Input Parameters

string
required
string
required
Slug: NEON_MCP_RESTORE_SNAPSHOTRestore a snapshot onto a new or existing branch. The call waits until the branch is ready. Pass target_branch_id to restore onto an existing branch; omit it to create one. Pass finalize: false then call finalize_branch_restore to swap names later.

Input Parameters

string
boolean
Finalize immediately (move computes onto the restored branch). Defaults to true when restoring as a new branch and false when restoring onto an existing branch.
string
required
string
required
string
Slug: NEON_MCP_RUN_SQLExecute one SQL statement on a Neon database. If a prior step created a temporary branch, pass that branch_id. NEVER run destructive SQL autonomously; always ask the user first.

Input Parameters

string
required
The SQL query to execute
string
An optional ID of the branch to execute the query against. If not provided the default branch is used.
string
required
The ID of the project to execute the query against
string
The name of the database. If not provided, the default neondb or first available database is used.
Slug: NEON_MCP_RUN_SQL_TRANSACTIONExecute multiple SQL statements as one transaction. If a prior step created a temporary branch, pass that branch_id. NEVER run destructive SQL autonomously; always ask the user first.

Input Parameters

string
An optional ID of the branch to execute the query against. If not provided the default branch is used.
string
required
The ID of the project to execute the query against
string
The name of the database. If not provided, the default neondb or first available database is used.
array
required
The SQL statements to execute
Slug: NEON_MCP_SEARCHSearch 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).

Input Parameters

string
required
The search query to find matching organizations, projects, or branches
Slug: NEON_MCP_SET_DEFAULT_BRANCHSets the specified branch as the project’s default branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
Slug: NEON_MCP_SET_SNAPSHOT_SCHEDULEReplace a branch’s automatic snapshot schedule. Frequency must be daily, weekly, or monthly.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

array
required
string
required
string
required
Slug: NEON_MCP_START_POSTGRES_ENDPOINTStarts a compute endpoint.

Input Parameters

string
required
string
required
Slug: NEON_MCP_SUSPEND_POSTGRES_ENDPOINTSuspends the specified compute endpoint.

Input Parameters

string
required
string
required
Slug: NEON_MCP_UPDATE_AUTH_CONFIGUpdates the auth configuration for the branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
Slug: NEON_MCP_UPDATE_AUTH_OAUTH_PROVIDERUpdates an OAuth provider for the specified project.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
string
required
string
string ("google" | "github" | "microsoft" | "vercel")
required
string
Slug: NEON_MCP_UPDATE_AUTH_USER_ROLEUpdates the role of a user in the Neon Auth user directory for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

array
required
string
required
string
required
string
required
Slug: NEON_MCP_UPDATE_BRANCHUpdates the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
string
required
boolean
string
string
required
Slug: NEON_MCP_UPDATE_DATA_APIUpdates the Neon Data API configuration for the specified branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
array
string
required
integer
string
string
string
required
string
string
boolean
boolean
integer
string
Slug: NEON_MCP_UPDATE_FUNCTIONUpdates the function’s mutable metadata — currently only the display name.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
required
string
required
string
required
string
required
Slug: NEON_MCP_UPDATE_POSTGRES_DATABASEUpdates the specified database in the branch.branch_id is a branch id (br-…), not a branch name. Call list_branches to resolve a name.

Input Parameters

string
string
required
string
string
required
string
required
Slug: NEON_MCP_UPDATE_POSTGRES_ENDPOINTUpdates the specified compute endpoint.

Input Parameters

string
boolean
object
string
string
required
string
required
string ("transaction")
string
boolean
boolean
integer
number
number
Slug: NEON_MCP_UPDATE_PROJECTUpdates the specified project.

Input Parameters

string
object
string
required
object
integer
Slug: NEON_MCP_UPDATE_SNAPSHOTUpdates the specified snapshot.

Input Parameters

string
string
string
required
string
required