TOOL API

run_sql

<use_case> Use this tool to execute a single SQL statement against a Neon database. </use_case> <important_notes> If you have a temporary branch from a prior step, you MUST: 1. Pass the branch ID to this tool unless explicitly told otherwise 2. Tell the user that you are using the temporary branch with ID [branch_id] </important_notes>

devOAuth1 credits

Call information

Tool slug: mcp-server-neon.run_sql
Provider: Neon
Average response: 0 ms
Calls in 7 days: 0

Input parameters

sqlrequired

The SQL query to execute

project_id

The ID of the project to execute the query against. Required for an unscoped connection. May be omitted when the connection is scoped to one project; if provided, it must match that project.

branch_id

An optional ID of the branch to execute the query against. If not provided the default branch is used.

database_name

The name of the database. If not provided, the default neondb or first available database is used.

role_name

An optional Postgres role to log in as. The server resolves its credentials internally and never returns them. If not provided, the database owner is used. On a connection pinned to a role, omit this or pass that role.

compute_id

An optional ID of the compute/endpoint to run on. If not provided, the read-write compute of the branch is used.