{
 "kind": "mcp",
 "slug": "com-neon-mcp",
 "path": "mcp/servers/com-neon-mcp/",
 "name": "Neon",
 "maker": "neondatabase",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Databases",
   "mcp/databases/"
  ]
 ],
 "lead": "manage Neon Postgres databases from your AI assistant.",
 "chips": [
  {
   "label": "Databases",
   "path": "mcp/databases/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http neon https://mcp.neon.tech/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/neondatabase/mcp-server-neon"
  },
  {
   "label": "Website",
   "href": "https://neon.com/docs/ai/neon-mcp-server"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "\"author\": \"Neon, Inc. (https://neon.com/)\"",
   "note": "The repository belongs to the neondatabase organization, the package names Neon, Inc. as author, the server runs on Neon's own domain mcp.neon.tech, and Neon's documentation links to this repository.",
   "src": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/package.json"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "1 secret needed",
   "status": "info",
   "sub": "NEON_API_KEY (only for the API key option; the default sign-",
   "quote": "claude mcp add --transport http neon https://mcp.neon.tech/mcp",
   "note": "The config with only url works in most clients; the README also gives an API key variant with an Authorization header and an mcp-remote bridge for clients that only run local servers.",
   "src": "https://neon.com/guides/claude-code-mcp-neon.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "Endpoint: https://mcp.neon.tech/mcp. Checked: yes: https://mcp.neon.tech/mcp answered 401 (sign-in required) to one unauthenticated GET on 2026-11-10.",
   "src": "https://mcp.neon.tech/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "MIT license",
   "quote": "\"license\": \"MIT\"",
   "note": "The server code is MIT; the Neon service it acts on follows your Neon plan.",
   "src": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/package.json"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Neon does",
   "parts": [
    {
     "t": "prose",
     "text": "Neon's own connector lets an AI assistant like Claude Code, Cursor or Codex work with your Neon Postgres databases. You ask in plain words, and it creates databases and branches, runs queries and tries schema changes on a temporary copy first. Neon recommends it for development and testing, not for live production data."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "A database for a new app",
       "text": "Ask your assistant to create a Postgres database and a users table, and it does it in your Neon account. You skip the clicking through dashboards.",
       "idea": false
      },
      {
       "title": "Try a table change on a copy",
       "text": "Adding a column or changing a table first runs on a temporary copy of your database. You check the result, then say yes or no before it touches the main data.",
       "idea": false
      },
      {
       "title": "Let the assistant only read",
       "text": "Give the assistant a read-only connection to one project, so it can look at tables and answer questions about your data but cannot change or delete anything.",
       "idea": false
      },
      {
       "title": "Find out why the app is slow",
       "text": "Ask why your database is slow or large. The assistant runs ready-made checks for slow queries, unused indexes and table sizes instead of guessing.",
       "idea": false
      },
      {
       "title": "Check what the assistant may do",
       "text": "Before you connect, see the exact list of actions a chosen setup gives the assistant. No sign-in is needed for this preview.",
       "idea": false
      },
      {
       "title": "A test copy for each feature",
       "text": "Before building a new feature, ask for a branch of the database, try the changes there, and delete the branch when you are done.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Neon popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "666",
       "l": "GitHub stars, neondatabase/mcp-server-neon"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (141)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "add_auth_oauth_provider",
       "text": "Adds a social login provider to a branch's Neon Auth."
      },
      {
       "name": "add_auth_trusted_domain",
       "text": "Adds a domain a branch's Neon Auth may redirect to after sign-in."
      },
      {
       "name": "compare_database_schema",
       "text": "Diffs one database's SQL schema on a branch against another branch, by default its parent. Risk: read-only."
      },
      {
       "name": "complete_database_migration",
       "text": "Applies or discards a prepared migration and deletes the temporary branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "complete_query_tuning",
       "text": "Applies or discards query-tuning changes and deletes the temporary branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "count_projects",
       "text": "Counts an organization's active projects without listing them; ones being created or deleted are not counted. Risk: read-only."
      },
      {
       "name": "create_auth_oauth_client",
       "text": "Registers an OAuth client with a branch's Neon Auth OAuth server."
      },
      {
       "name": "create_auth_user",
       "text": "Creates a Neon Auth user on a branch who can sign in right away."
      },
      {
       "name": "create_branch",
       "text": "Creates a branch from its parent's current data, with a read-write compute unless no_compute, and waits until it is ready."
      },
      {
       "name": "create_credential",
       "text": "Issues a scoped credential on a branch."
      },
      {
       "name": "create_postgres_database",
       "text": "Creates a database on a branch, owned by owner_name."
      },
      {
       "name": "create_postgres_endpoint",
       "text": "Creates a compute endpoint on a branch; a branch takes one read-write endpoint and any number of read-only."
      },
      {
       "name": "create_postgres_role",
       "text": "Creates a Postgres role on a branch and returns its password."
      },
      {
       "name": "create_project",
       "text": "Creates a project with a default branch and read-write compute and waits until it is ready."
      },
      {
       "name": "create_snapshot",
       "text": "Creates a snapshot of a branch."
      },
      {
       "name": "create_storage_bucket",
       "text": "Creates an object storage bucket on a branch."
      },
      {
       "name": "create_trigger",
       "text": "Creates a trigger that calls a function on a five-field UTC cron schedule, or after an upload to one bucket, optionally under a key prefix."
      },
      {
       "name": "delete_auth_oauth_client",
       "text": "Deletes an OAuth client from Neon Auth's OAuth server, irreversibly; tokens already issued stay valid. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_auth_oauth_provider",
       "text": "Removes a social login provider from a branch's Neon Auth. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_auth_trusted_domain",
       "text": "Removes a domain from the ones a branch's Neon Auth may redirect to. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_auth_user",
       "text": "Deletes a Neon Auth user from a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_branch",
       "text": "Deletes a branch with all its data and disconnects its clients. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_data_api",
       "text": "Deletes the Neon Data API for a database; requests to its endpoint start failing. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_function",
       "text": "Deletes a function from a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_functions_custom_domain",
       "text": "Removes a custom domain from a branch and stops routing it. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_postgres_database",
       "text": "Deletes a database and its data from a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_postgres_endpoint",
       "text": "Deletes a compute endpoint and drops its connections. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_postgres_role",
       "text": "Deletes a Postgres role from a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_project",
       "text": "Deletes a project with all its branches, computes, databases, and roles. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_snapshot",
       "text": "Deletes a snapshot. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_storage_bucket",
       "text": "Deletes a bucket from a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_storage_object",
       "text": "Deletes one object from a bucket on a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_storage_objects_by_prefix",
       "text": "Soft-deletes every object on this branch whose key starts with prefix and returns the count; inherited objects stay. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "delete_trigger",
       "text": "Deletes a function trigger, or hides an inherited one on this branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "deploy_function",
       "text": "Deploys a function version from any of zip, environment, and runtime; omitted ones keep the latest value, and the first deployment needs zip. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "describe_branch",
       "text": "Returns a branch summary, its database names, and a tree of one database's schemas, tables, views, indexes, sequences, and functions. Risk: read-only."
      },
      {
       "name": "describe_project",
       "text": "Gets a project's settings, owner, and usage. Risk: read-only."
      },
      {
       "name": "describe_table_schema",
       "text": "Returns a table's columns, indexes, constraints, and sizes. Risk: read-only."
      },
      {
       "name": "disable_auth",
       "text": "Disables Neon Auth on a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "disable_realtime",
       "text": "Disables Realtime on a branch, discarding its secret, and waits until it is applied. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "enable_realtime",
       "text": "Enables Realtime on a branch, or changes its allowed origins, and waits until it is applied."
      },
      {
       "name": "explain_sql_statement",
       "text": "Returns a statement's execution plan as JSON. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "fetch",
       "text": "Returns an organization, project, branch, compute, or snapshot by an id from search: markdown text, console URL, and records in metadata. Risk: read-only."
      },
      {
       "name": "finalize_branch_restore",
       "text": "Finalizes a branch restored with finalize false: moves the original branch's computes onto it, restarting them, and takes over its name. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "get_ai_gateway",
       "text": "Gets a branch's AI Gateway host; a 404 says why it is unavailable. Risk: read-only."
      },
      {
       "name": "get_auth",
       "text": "Gets a branch's Neon Auth integration record: provider, base URL, JWKS URL, and database. Risk: read-only."
      },
      {
       "name": "get_auth_oauth_client",
       "text": "Gets an OAuth client of a branch's Neon Auth OAuth server, without its secret. Risk: read-only."
      },
      {
       "name": "get_auth_oauth_server",
       "text": "Gets a branch's Neon Auth OAuth 2.1 server settings (oauth_provider plugin), for example for MCP clients. Risk: read-only."
      },
      {
       "name": "get_branch",
       "text": "Gets a branch record: name, parent, state, protection, size, and timestamps. Risk: read-only."
      },
      {
       "name": "get_branch_consumption",
       "text": "Returns per-branch consumption for project_ids. Risk: read-only."
      },
      {
       "name": "get_connection_string",
       "text": "Returns a Postgres connection string with a role password; the branch needs a compute."
      },
      {
       "name": "get_data_api",
       "text": "Gets the Neon Data API configuration for one database on a branch. Risk: read-only."
      },
      {
       "name": "get_database_tables",
       "text": "Lists a database's tables and views outside the system schemas. Risk: read-only."
      },
      {
       "name": "get_default_branch",
       "text": "Gets the project's default branch by its default flag, not its name. Risk: read-only."
      },
      {
       "name": "get_doc",
       "text": "Returns one neon.com page as markdown, by the slug of a search_docs hit. Risk: read-only."
      },
      {
       "name": "get_function",
       "text": "Gets a function on a branch by slug. Risk: read-only."
      },
      {
       "name": "get_neon_auth_config",
       "text": "Returns a branch's Neon Auth integration and settings: trusted origins, localhost, email and password, OAuth and email providers, plugins, webhook, and logs export, with secrets redacted. Risk: read-only."
      },
      {
       "name": "get_operation",
       "text": "Gets one operation and its status. Risk: read-only."
      },
      {
       "name": "get_postgres_database",
       "text": "Gets a database on a branch and its owner. Risk: read-only."
      },
      {
       "name": "get_postgres_endpoint",
       "text": "Gets a compute endpoint (ep-...), including its host and state. Risk: read-only."
      },
      {
       "name": "get_postgres_role",
       "text": "Gets a Postgres role on a branch. Risk: read-only."
      },
      {
       "name": "get_project_consumption",
       "text": "Returns per-project consumption in an organization. Risk: read-only."
      },
      {
       "name": "get_realtime",
       "text": "Gets a branch's Realtime state, URL, and allowed origins; the secret comes from get_realtime_secret. Risk: read-only."
      },
      {
       "name": "get_realtime_secret",
       "text": "Gets the secret the application backend issues Realtime tokens with; 404 until enable_realtime has run."
      },
      {
       "name": "get_snapshot_schedule",
       "text": "Gets a branch's automatic snapshot schedule. Risk: read-only."
      },
      {
       "name": "get_storage",
       "text": "Checks whether object storage is available on a branch; a 404 says why not. Risk: read-only."
      },
      {
       "name": "get_trigger",
       "text": "Gets a function trigger on a branch. Risk: read-only."
      },
      {
       "name": "inspect_database",
       "text": "Runs one read-only neon inspect db check; some are compute-wide. Risk: read-only."
      },
      {
       "name": "list_auth_oauth_clients",
       "text": "Lists the OAuth clients (apps, MCP clients) of a branch's Neon Auth OAuth server, without secrets; not social login providers. Risk: read-only."
      },
      {
       "name": "list_auth_oauth_providers",
       "text": "Lists the social login providers (Google, GitHub, Microsoft, Vercel, Apple) of a branch's Neon Auth."
      },
      {
       "name": "list_auth_trusted_domains",
       "text": "Lists the domains a branch's Neon Auth may redirect to after sign-in. Risk: read-only."
      },
      {
       "name": "list_branch_computes",
       "text": "Lists a branch's compute endpoints. Risk: read-only."
      },
      {
       "name": "list_branches",
       "text": "Lists a project's branches with id (br-...), name, parent, and default flag; search finds a branch's id by name. Risk: read-only."
      },
      {
       "name": "list_credentials",
       "text": "Lists the scoped credentials issued on a branch, without secrets. Risk: read-only."
      },
      {
       "name": "list_functions",
       "text": "Lists the functions on a branch. Risk: read-only."
      },
      {
       "name": "list_functions_custom_domains",
       "text": "Lists a branch's custom domains and their targets. Risk: read-only."
      },
      {
       "name": "list_incidents",
       "text": "Lists open Neon incidents and maintenance from neonstatus.com and the affected components and regions. Risk: read-only."
      },
      {
       "name": "list_log_field_values",
       "text": "Lists the distinct values of one log field; a field the branch never emitted returns unknown_field. Risk: read-only."
      },
      {
       "name": "list_log_fields",
       "text": "Lists the low-cardinality log fields seen on a branch, for list_log_field_values. Risk: read-only."
      },
      {
       "name": "list_operations",
       "text": "Lists a project's operations; ones older than six months may be gone. Risk: read-only."
      },
      {
       "name": "list_organizations",
       "text": "Lists the organizations the user belongs to; an organization API key gets its own organization. Risk: read-only."
      },
      {
       "name": "list_postgres_databases",
       "text": "Lists a branch's databases and their owners. Risk: read-only."
      },
      {
       "name": "list_postgres_endpoints",
       "text": "Lists the compute endpoints of every branch in a project. Risk: read-only."
      },
      {
       "name": "list_postgres_roles",
       "text": "Lists a branch's Postgres roles. Risk: read-only."
      },
      {
       "name": "list_project_members",
       "text": "Lists organization members and their roles on an org-owned project; 404 when the project is not org-owned or per-project roles are off. Risk: read-only."
      },
      {
       "name": "list_project_permissions",
       "text": "Lists who has access to a project: each permission id, email, and grant date. Risk: read-only."
      },
      {
       "name": "list_projects",
       "text": "Lists the projects in an organization; search filters by name or id. Risk: read-only."
      },
      {
       "name": "list_regions",
       "text": "Lists the regions you can create projects in. Risk: read-only."
      },
      {
       "name": "list_slow_queries",
       "text": "Lists queries from pg_stat_statements, slowest mean execution time first. Risk: read-only."
      },
      {
       "name": "list_snapshots",
       "text": "Lists a project's snapshots. Risk: read-only."
      },
      {
       "name": "list_storage_buckets",
       "text": "Lists a branch's object storage buckets, inherited ones included. Risk: read-only."
      },
      {
       "name": "list_storage_objects",
       "text": "Lists a bucket's objects on a branch, inherited ones included. Risk: read-only."
      },
      {
       "name": "list_triggers",
       "text": "Lists a branch's function triggers, including inherited ones, which stay disabled on this branch until enabled. Risk: read-only."
      },
      {
       "name": "prepare_database_migration",
       "text": "Applies a schema change on a new temporary branch and returns a migration_id."
      },
      {
       "name": "prepare_query_tuning",
       "text": "Runs EXPLAIN ANALYZE for a slow query on a new temporary branch; returns the plan, table schemas, and a tuning_id."
      },
      {
       "name": "presign_storage_object",
       "text": "Returns a short-lived presigned PUT or GET URL for one object, with the headers to send; no S3 credentials needed. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "provision_neon_auth",
       "text": "Enables Neon Auth on a branch and creates the neon_auth schema in its database."
      },
      {
       "name": "provision_neon_data_api",
       "text": "Creates the Neon Data API, a REST interface over database_name, on a branch."
      },
      {
       "name": "query_logs",
       "text": "Returns a branch's log records. Risk: read-only."
      },
      {
       "name": "query_loki_logs",
       "text": "Runs a LogQL range query on a branch's logs and returns Loki's response: data.result groups lines by stream label as [nanosecond timestamp, line]. Risk: read-only."
      },
      {
       "name": "recover_project",
       "text": "Recovers a project deleted in the last 7 days; list_projects with recoverable true finds them."
      },
      {
       "name": "register_functions_custom_domain",
       "text": "Routes a domain you own to a function: entity_type function, entity_id the slug from list_functions."
      },
      {
       "name": "reset_from_parent",
       "text": "Resets a branch to its parent's current state, discarding the branch's own changes. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "reset_postgres_role_password",
       "text": "Sets a new random password for a Postgres role and returns it. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "restart_postgres_endpoint",
       "text": "Restarts a compute endpoint by suspending and starting it, dropping its connections. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "restore_snapshot",
       "text": "Restores a snapshot onto a new branch or onto target_branch_id and waits until it is ready. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "revoke_credential",
       "text": "Revokes a scoped credential. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "rotate_auth_oauth_client_secret",
       "text": "Issues a new secret for a confidential OAuth client; the old one stops working at once. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "rotate_credential",
       "text": "Replaces a scoped credential's secrets in place and returns them once; token_id stays. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "rotate_realtime_secret",
       "text": "Replaces a branch's Realtime secret and waits until the old one stops working. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "run_sql",
       "text": "Runs one SQL statement on a branch's database and returns its rows. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "run_sql_transaction",
       "text": "Runs several SQL statements in one transaction and returns each one's rows. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "search",
       "text": "Finds organizations, projects (including shared ones), branches, computes, and snapshots whose name or id contains query, with ids for fetch. Risk: read-only."
      },
      {
       "name": "search_docs",
       "text": "Searches neon.com docs, API reference, PostgreSQL tutorial, guides, FAQs, changelog, and blog for ranked pages with the slug get_doc reads. Risk: read-only."
      },
      {
       "name": "send_auth_test_email",
       "text": "Sends a test email through the branch's saved standard SMTP provider to recipient_email."
      },
      {
       "name": "send_feedback",
       "text": "Sends anonymous feedback text to the Neon team, with no account, project, or connection details. Risk: read-only."
      },
      {
       "name": "set_default_branch",
       "text": "Makes a branch the project's default; the previous default loses the flag. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "set_snapshot_schedule",
       "text": "Replaces a branch's automatic snapshot schedule. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "start_postgres_endpoint",
       "text": "Starts a suspended compute endpoint."
      },
      {
       "name": "suspend_postgres_endpoint",
       "text": "Suspends a compute endpoint, dropping its connections. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_allow_localhost",
       "text": "Sets whether a branch's Neon Auth accepts localhost origins; turn it off for production. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_config",
       "text": "Sets the application name Neon Auth uses in its emails. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_email_and_password",
       "text": "Updates a branch's Neon Auth email and password sign-in; omitted fields keep their value. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_email_provider",
       "text": "Sets the email provider for Neon Auth's emails: body.type \"shared\" for Neon's sender, or \"standard\" with your SMTP details. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_logs_export",
       "text": "Turns the export of a branch's Neon Auth events to Neon Platform logs on or off. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_oauth_client",
       "text": "Updates an OAuth client of Neon Auth's OAuth server; redirect_uris and resources replace the stored lists, and type cannot change. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_oauth_provider",
       "text": "Updates a social login provider on a branch's Neon Auth. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_oauth_server",
       "text": "Configures a branch's Neon Auth as an OAuth 2.1 server (oauth_provider plugin); root branch only. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_plugins_magic_link",
       "text": "Updates the Neon Auth magic link plugin; omitted fields keep their value. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_plugins_organization",
       "text": "Updates the Neon Auth organization plugin, which lets your app's users form organizations (not Neon organizations). Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_plugins_phone_number",
       "text": "Updates the Neon Auth SMS OTP plugin; omitted fields keep their value. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_user_role",
       "text": "Sets the roles of a Neon Auth user on a branch. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_auth_webhooks",
       "text": "Replaces a branch's Neon Auth webhook configuration; omitted fields reset, so { enabled: false } alone clears webhook_url and enabled_events. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_branch",
       "text": "Renames a branch, protects or unprotects it, or sets when it expires. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_data_api",
       "text": "Updates the Neon Data API settings for a database and refreshes its schema cache. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_function",
       "text": "Sets a function's display name; null resets it to the slug. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_postgres_database",
       "text": "Renames a database or changes its owner. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_postgres_endpoint",
       "text": "Updates a compute endpoint's settings. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_project",
       "text": "Updates a project's name, settings, default compute settings, or history retention. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_snapshot",
       "text": "Renames a snapshot or changes when it expires. Risk: changes or deletes data (destructive hint in the code)."
      },
      {
       "name": "update_trigger",
       "text": "Updates a function trigger; body.type must match its kind. Risk: changes or deletes data (destructive hint in the code)."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "every tool call with its arguments, including SQL text and query results",
       "sub": "To Neon (mcp.neon.tech, then the Neon API and your database); on each tool call; this is how the server works. Opt out: none; use readonly, projectId, category and roleName to limit what it can reach."
      },
      {
       "l": "Sends",
       "v": "your Neon account ID, name and email, then each tool name, sign-in method and client name (not arguments or results)",
       "sub": "To Neon product analytics (Segment, via track.neon.tech); when you connect with an account and on each tool call. Opt out: not on the hosted server; NEON_MCP_DISABLE_ANALYTICS=1 only when you run the server yourself."
      },
      {
       "l": "Sends",
       "v": "error reports and traces with tool name, client name and account ID",
       "sub": "To Sentry; on errors and on each request. Opt out: none; the analytics flag does not turn Sentry off."
      },
      {
       "l": "Sends",
       "v": "the feedback text only",
       "sub": "To the Neon team; only when the send_feedback tool is called. Opt out: do not call send_feedback."
      }
     ]
    },
    {
     "t": "prose",
     "text": "The server's code is free and open under the MIT license, also for paid work. Using it means using your Neon account, under Neon's own plans and terms."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The server code is MIT; the Neon service it acts on follows your Neon plan.",
       "quote": "\"license\": \"MIT\"",
       "src": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/package.json"
      },
      {
       "l": "client-work",
       "v": "Yes",
       "status": "yes",
       "sub": "MIT allows use for any purpose; each client's database lives in their own Neon account.",
       "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction",
       "src": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/LICENSE"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "Copies of the code must keep the MIT copyright and permission notice.",
       "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
       "src": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/LICENSE"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "2.0.0 in the registry, updated Nov 5, 2026"
      },
      {
       "l": "Last release",
       "v": "2.0.0 (2026-11-05, CHANGELOG); unreleased changes on main at the pinned commit"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: https://mcp.neon.tech/mcp answered 401 (sign-in required) to one unauthenticated GET on 2026-11-10",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Neon",
       "me": true,
       "facts": [
        "666 stars",
        "Remote"
       ]
      },
      {
       "name": "com-supabase-mcp",
       "why": "Pick it if your database and sign-in are on Supabase",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "DBHub",
       "why": "Pick it if you need MySQL, SQL Server, Oracle or SQLite, or Postgres hosted elsewhere",
       "path": "mcp/servers/io-github-bytebase-dbhub/",
       "facts": [
        "3,870 stars",
        "Local",
        "in 23 projects"
       ]
      },
      {
       "name": "neondatabase",
       "why": "Pick it if your app (not the assistant) needs to query Neon from serverless code",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All databases servers",
     "more_path": "mcp/databases/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Connect the hosted Neon MCP server at https://mcp.neon.tech/mcp?readonly=true, list my Neon projects and the tables in my main database, and ask me before any change."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http neon https://mcp.neon.tech/mcp"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"Neon\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema\"\n    }\n  }\n}\n"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"neon\": {\n      \"url\": \"https://mcp.neon.tech/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "The config with only url works in most clients; the README also gives an API key variant with an Authorization header and an mcp-remote bridge for clients that only run local servers."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "\"url\": \"https://mcp.neon.tech/sse\"",
       "fix": "\"url\": \"https://mcp.neon.tech/mcp\"",
       "why": "The old SSE address is retired and answers 410 Gone."
      },
      {
       "dont": "Installing the local npm package @neondatabase/mcp-server-neon",
       "fix": "Connect to https://mcp.neon.tech/mcp, or bridge with npx -y mcp-remote https://mcp.neon.tech/mcp for stdio-only clients",
       "why": "The local package is deprecated."
      },
      {
       "dont": "Calling run_sql_transaction or get_connection_string on a read-only connection",
       "fix": "Use separate run_sql calls for reads; ask the person to copy DATABASE_URL from the Neon Console",
       "why": "Both tools are not available in read-only mode."
      },
      {
       "dont": "Pinning roleName to a role made in the Neon Console to limit what the agent reads",
       "fix": "Create the role with SQL and GRANT SELECT only on the tables it may read",
       "why": "Console-made roles belong to neon_superuser and can read all data."
      },
      {
       "dont": "Running complete_database_migration, delete_branch or delete_project without asking",
       "fix": "Show the person the change and wait for a yes",
       "why": "The tool descriptions in the server say never to run them on their own."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need an API key?",
       "a": "No. The hosted server signs you in through a Neon page in the browser; an API key is only an option for clients without that sign-in.",
       "evidence": {
        "url": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/README.md",
        "quote": "This is the easiest setup, requires no local installation of this server, and doesn't need a Neon API key configured in the client."
       }
      },
      {
       "q": "Can it delete my data?",
       "a": "Yes, with write access. Tools like delete_project and delete_branch remove data; a deleted project can be recovered within 7 days.",
       "evidence": {
        "url": "https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/mcp/__tests__/__snapshots__/hosted-tools-catalog.md",
        "quote": "recover_project undoes it within 7 days."
       }
      },
      {
       "q": "Can I limit it to one project?",
       "a": "Yes. Add projectId to the server address; project-wide tools like list_projects and create_project are then hidden.",
       "evidence": {
        "url": "https://neon.com/docs/ai/neon-mcp-server.md",
        "quote": "Cross-project search and navigation are disabled in this mode, and project management tools such as `list_projects` and `create_project` are hidden."
       }
      },
      {
       "q": "Should I install the npm package @neondatabase/mcp-server-neon?",
       "a": "No. The local package is deprecated; connect to the hosted server, or bridge to it with mcp-remote if your client only runs local servers.",
       "evidence": {
        "url": "https://neon.com/docs/ai/neon-mcp-server.md",
        "quote": "The local stdio package (`@neondatabase/mcp-server-neon`) is deprecated."
       }
      },
      {
       "q": "Can it read Neon's documentation without an account?",
       "a": "Yes. The docs tools (search_docs and get_doc) work without signing in.",
       "evidence": {
        "url": "https://neon.com/docs/ai/neon-mcp-server.md",
        "quote": "Search and read Neon docs, the API reference, guides, the PostgreSQL tutorial, the blog, and the changelog from within your assistant (no OAuth required)"
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "com.neon/mcp"
  ],
  [
   "Category",
   "Databases"
  ],
  [
   "Version",
   "2.0.0"
  ],
  [
   "Remote endpoint",
   "https://mcp.neon.tech/mcp"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "GitHub",
   "neondatabase/mcp-server-neon"
  ],
  [
   "In the registry since",
   "Nov 5, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "Neon says to use it for development and testing only and never to connect it to production databases.",
  "With write access it can delete whole projects, branches, databases and users. Read every action before you approve it.",
  "When you sign in, the server sends your Neon account number, name and email to Neon's analytics, plus the name of each action it runs."
 ],
 "checked_line": "Read by AgentGid from 11 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/neondatabase.png"
}