Connect Neon to AI agents

Connect Neon to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Deploy NeonBook a demo

Supported Tools

get_project

Get Project

Retrieves detailed information about a specific Neon project, including its configuration, connection URI, consumption metrics, and settings.

list_projects

List Projects

Lists all Neon projects accessible to the authenticated user. Supports searching by name or ID and filtering by organization. Returns project metadata including region, Postgres version, and timestamps.

list_branches

List Branches

Lists all branches in a Neon project. Branches contain databases and can be created from any point in the project's history retention window.

get_operation

Get Operation

Retrieves the details and current status of a specific operation. Use this to poll for completion of asynchronous operations before proceeding with dependent tasks.

delete_database

Delete Database

Permanently deletes a database from a branch in a Neon project.

update_project

Update Project

Updates an existing Neon project's settings, including its name and default endpoint configuration.

delete_endpoint

Delete Endpoint

Deletes a compute endpoint from a Neon project. The branch and its data remain intact.

list_endpoints

List Endpoints

Lists all compute endpoints in a Neon project. Endpoints are processing instances that connect to branches and provide database connectivity.

create_project

Create Project

Creates a new Neon project. A project is the top-level organizational unit that contains branches, databases, and compute endpoints. You can specify the region, Postgres version, and default compute settings.

update_database

Update Database

Updates a database's name or owner on a specific branch. Can be used to rename a database or transfer ownership to another role.

create_branch

Create Branch

Creates a new branch in a Neon project. Branches are copies of the parent branch's data at a specific point in time. Optionally creates a compute endpoint for the branch so it can accept connections.

delete_project

Delete Project

Permanently deletes a Neon project and all its branches, databases, endpoints, and roles. The project can be recovered within the deletion grace period using the recover project tool.

list_databases

List Databases

Lists all databases on a specific branch in a Neon project. Each database belongs to a branch and has an owner role.

list_roles

List Roles

Lists all database roles on a specific branch. Roles control database access and permissions. They are copied to child branches upon creation.

create_endpoint

Create Endpoint

Creates a new compute endpoint for a branch. Endpoints provide the processing power for running queries. Each branch supports one read-write endpoint and multiple read-only (replica) endpoints.

create_role

Create Role

Creates a new database role on a branch. The role will be available for database access and can be assigned as a database owner.

restore_branch

Restore Branch

Restores a branch to a previous state using a point-in-time timestamp or LSN. Optionally preserves the current state under a new branch name before restoring.

delete_role

Delete Role

Deletes a database role from a branch. The role must not own any databases.

get_consumption

Get Consumption

Retrieves consumption metrics across all projects for the account. Tracks compute time, active time, storage, written data, and data transfer. Available on Neon paid plans.

control_endpoint

Control Endpoint

Starts, suspends, or restarts a compute endpoint. Use this to manage the lifecycle of compute instances — wake up suspended endpoints, suspend active ones to save costs, or restart for configuration changes.

create_database

Create Database

Creates a new database on a branch in a Neon project. Each database requires an owner role. There is a limit of 500 databases per branch.

reset_role_password

Reset Role Password

Resets the password for a database role. Returns the new generated password. Use this when credentials need to be rotated or if the current password has been lost.

delete_branch

Delete Branch

Deletes a branch from a Neon project. This also deletes all databases, roles, and compute endpoints associated with the branch.

update_endpoint

Update Endpoint

Updates a compute endpoint's autoscaling limits and suspend timeout configuration.

list_operations

List Operations

Lists recent operations for a Neon project. Operations are asynchronous tasks like creating branches, starting compute endpoints, or applying configuration changes. Use this to track the progress and status of background tasks.

list_snapshots

List Snapshots

Lists snapshots for a Neon project. Snapshots are point-in-time backups of project data.

update_branch

Update Branch

Updates a Neon branch name, protected flag, or expiration timestamp. Set expiresAt to null to remove the expiration timestamp.

set_default_branch

Set Default Branch

Sets a branch as the default branch for a Neon project. The previous default branch is automatically unset.

reveal_role_password

Reveal Role Password

Retrieves the stored password for a Neon database role when password storage is enabled. Use reset_role_password when the password should be rotated instead.

restore_snapshot

Restore Snapshot

Restores a Neon snapshot to a branch. By default Neon creates a restored branch for preview; set finalizeRestore only when you intend to replace the target branch.

get_branch

Get Branch

Retrieves details for a specific Neon branch, including its parent, state, default/protected flags, and timestamps.

recover_project

Recover Project

Recovers a deleted Neon project within the deletion recovery period. Restores branches, endpoints, settings, and connection strings when Neon can still recover the project.

update_snapshot

Update Snapshot

Renames a Neon project snapshot.

get_connection_uri

Get Connection URI

Retrieves a PostgreSQL connection URI for a Neon database and role. Use pooled=true to request a pooled connection URI.

create_snapshot

Create Snapshot

Creates a point-in-time snapshot from a Neon branch. Provide either lsn or timestamp to snapshot a specific historical point, not both.

get_role

Get Role

Retrieves details for a database role on a Neon branch, including protection and authentication metadata.

get_database

Get Database

Retrieves details for a specific database on a Neon branch, including owner role and timestamps.

recover_branch

Recover Branch

Recovers a soft-deleted Neon branch within the deletion recovery period when branch recovery is available for the project.

get_endpoint

Get Endpoint

Retrieves details for a specific Neon compute endpoint, including state, host, autoscaling limits, suspend timeout, and access flags.

list_regions

List Regions

Lists supported Neon regions. Use this before creating projects to choose a valid region ID. Pass orgId to see the regions available to a specific Neon organization.

delete_snapshot

Delete Snapshot

Deletes a Neon project snapshot.

More integrations teams use with Neon

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Track issues with the built-in issue tracker. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

Heroku

Deploy, manage, and scale applications on Heroku's cloud platform. Create and configure apps, scale dynos, provision add-ons (databases, caching, etc.), manage configuration variables, build and release code, add custom domains and SSL certificates, manage collaborators and team permissions, configure pipelines for continuous delivery, set up log drains, and sync data with Salesforce via Heroku Connect. Subscribe to webhooks for real-time notifications on app changes, builds, releases, dyno lifecycle events, and more.

How to use Neon on Metorial

Neon Branch Restore and Schema Comparison for Production Incidents

When a production data issue is detected, quickly restore a Neon branch to a point in time before the incident, compare schemas between the restored and current branch, and validate database roles before handing off to engineering.

Neon Database Branch Provisioning for Feature Development

Automate the creation of isolated Neon database branches for each feature being developed, configure compute endpoints with appropriate scaling settings, and clean up branches after merges to keep the project organized.

Technical notes for Neon

Manage serverless PostgreSQL databases on Neon. Create, update, and delete projects, branches, databases, compute endpoints, and roles. Configure autoscaling limits, suspend timeouts, and read replicas. Create branches from any point in time for development, testing, or backups. Compare schemas between branches and create anonymized data copies. Track consumption metrics including compute time, storage, and data transfer, and set quota limits. Manage organization members, permissions, and API keys. Monitor asynchronous operation status and query databases over HTTP via the Data API.

Connect Neon to production AI agents

See how Metorial gives Neon access the governance, tracing, and security controls teams need.

Book a demoDeploy Neon

Frequently asked questions

Common questions about connecting Neon to AI agents with Metorial.

  1. Can Metorial connect Neon to AI agents?
    Yes. Metorial connects AI agents to Neon through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.