> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mantle.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Neon

> Query and manage Neon serverless Postgres databases — create projects, branch databases, and execute SQL from Mantle

Connect your Neon account via OAuth and let your AI agents manage your serverless Postgres infrastructure: create
projects, branch databases for development, execute SQL queries, and manage endpoints — all from Mantle.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Database management" icon="database">
    Create and manage Postgres databases, branches, and roles across your Neon projects.
  </Card>

  <Card title="Branch workflows" icon="code-branch">
    Create database branches for development and testing — instant copies of your production data.
  </Card>

  <Card title="SQL execution" icon="terminal">
    Execute SQL queries through your agent — check data, run migrations, or debug issues.
  </Card>

  <Card title="Infrastructure control" icon="server">
    Manage compute endpoints, connection URIs, and project settings from chat.
  </Card>
</CardGroup>

***

## Connect Neon

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Neon**.
  </Step>

  <Step title="Authorize with OAuth">
    Click **Connect** and sign in to your Neon account. Grant Mantle the requested permissions to access your projects
    and databases.
  </Step>

  <Step title="Confirm the connection">
    Once authorized, you'll be redirected back to Mantle. The integration status will show as connected.
  </Step>
</Steps>

***

## Agent tools

Add Neon tools to agents that need them. Their access is limited by the connected account and selected tools.

### Projects

| Tool           | Description                               |
| -------------- | ----------------------------------------- |
| List projects  | List all projects in your Neon account    |
| Get project    | Retrieve details of a specific project    |
| Create project | Create a new Neon project with settings   |
| Update project | Modify project configuration and settings |
| Delete project | Remove a project and all its data         |

### Branches & Databases

| Tool               | Description                                 |
| ------------------ | ------------------------------------------- |
| Create branch      | Create a new branch from an existing one    |
| List branches      | List all branches in a project              |
| Create database    | Create a new database on a branch           |
| Get schema         | Retrieve the schema for a project branch    |
| Compare schemas    | Compare schemas between branches            |
| Set default branch | Set a branch as the default for the project |

### Endpoints & Roles

| Tool               | Description                                    |
| ------------------ | ---------------------------------------------- |
| Create endpoint    | Create a compute endpoint for a branch         |
| Get connection URI | Retrieve the connection string for an endpoint |
| Add role           | Create a new database role on a branch         |
| Reset password     | Reset the password for a database role         |
| List regions       | List available Neon regions                    |

***

## Triggers

<Note>
  Automated triggers for Neon are not yet available. Triggers will be added in a future update — check back soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Create a branch for a feature">
    Ask your agent to create a Neon branch from production for a new feature — it creates the branch, sets up a compute
    endpoint, and returns the connection string ready to use in your development environment.
  </Accordion>

  <Accordion title="Quick data lookup">
    Ask "How many users signed up this week?" and the agent executes the SQL query against your database and returns the
    result inline — no database client needed.
  </Accordion>

  <Accordion title="Schema comparison before merge">
    Before merging a feature branch, ask your agent to compare the branch schema against the main branch. It highlights
    new tables, modified columns, and missing indexes.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth connection failed">
    Make sure you are signing in with a Neon account that has access to the projects you want to manage. If the
    connection fails, try disconnecting and reconnecting from **Settings → Integrations → Neon**.
  </Accordion>

  <Accordion title="Agent can't find my project">
    Verify the connected Neon account has access to the project. If the project belongs to an organization, ensure your
    account has the correct organization membership.
  </Accordion>

  <Accordion title="SQL queries time out">
    Neon compute endpoints auto-suspend after inactivity. The first query after suspension may take a moment while the
    endpoint wakes up. If timeouts persist, check your endpoint's auto-suspend configuration.
  </Accordion>

  <Accordion title="Branch creation fails">
    Check that your Neon plan allows the number of branches you need. Free tier accounts have branch limits. Verify the
    source branch exists and has available capacity.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>