> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Supabase

**Authentication:** OAuth or personal access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List the largest tables in the `prod` schema by row count.
* Find rows in `users` created in the last 24 hours.
* Show me Edge Functions invoked more than 10,000 times in the last 7 days.

## Available Tools

#### list_api_keys

List all API keys for a Supabase project. Use list_projects to find project refs.

#### create_api_key

Create a new API key for a Supabase project. Name must be lowercase alphanumeric/underscores only (e.g. 'my_key'). Us...

#### get_api_key

Get details of a specific API key. Use list_api_keys to find key IDs.

#### update_api_key

Update an API key's name or description. Name must be lowercase alphanumeric/underscores only. Use list_api_keys to f...

#### delete_api_key

Delete an API key from a Supabase project. Use list_api_keys to find key IDs.

#### get_auth_config

Get the auth configuration for a Supabase project. Includes email/phone settings, JWT config, and signup rules.

#### update_auth_config

Update auth configuration for a Supabase project. Supports email/phone toggles, JWT expiry, signup, and token rotation.

#### list_branches

List all database branches for a Supabase project. Requires branching to be enabled. Use list_projects to find refs.

#### create_branch

Create a new database branch for a Supabase project. Requires branching to be enabled on the project.

#### get_branch_by_name

Get a database branch by name. Use list_branches to find branch names.

#### get_branch

Get details of a database branch by ID. Use list_branches to find branch IDs.

#### update_branch

Update a database branch's name or git branch association. Use list_branches to find IDs.

#### delete_branch

Delete a database branch. This is irreversible. Use list_branches to find IDs.

#### delete_all_branches

Delete all database branches for a project. This is irreversible. Disables branching.

#### push_branch

Push a database branch's migrations to the parent project. Use list_branches to find IDs.

#### merge_branch

Merge a database branch into the parent project. Use list_branches to find IDs.

#### reset_branch

Reset a database branch to match the parent project's schema. Use list_branches to find IDs.

#### diff_branch

Get the SQL diff between a database branch and its parent project. Use list_branches to find IDs.

#### execute_query

Execute a SQL query against a Supabase project's database. Supports DDL (CREATE TABLE, ALTER) and DML (SELECT, INSERT...

#### list_edge_functions

List all edge functions for a Supabase project. Use list_projects to find project refs.

#### create_edge_function

Create a new edge function in a Supabase project. Use list_projects to find project refs.

#### get_edge_function

Get details of an edge function. Use list_edge_functions to find function slugs.

#### update_edge_function

Update an edge function's name, body, or JWT settings. Use list_edge_functions to find slugs.

#### delete_edge_function

Delete an edge function from a Supabase project. Use list_edge_functions to find slugs.

#### list_migrations

List database migration history for a Supabase project. Use list_projects to find refs.

#### create_migration

Create and execute a database migration for a Supabase project. Rolls back on failure. Use list_projects to find refs.

#### list_organizations

List all organizations the authenticated user belongs to.

#### create_organization

Create a new Supabase organization.

#### list_organization_members

List members of a Supabase organization. Use list_organizations to find the organization slug.

#### list_projects

List all Supabase projects the authenticated user has access to.

#### create_project

Create a new Supabase project in an organization. Use list_organizations to find organization IDs.

#### get_project

Get details of a Supabase project by its reference ID. Use list_projects to find project refs.

#### update_project

Update a Supabase project's name. Use list_projects to find project refs.

#### delete_project

Delete a Supabase project. This is irreversible. Use list_projects to find project refs.

#### pause_project

Pause a Supabase project. Paused projects stop incurring compute costs. Use list_projects to find refs.

#### restore_project

Restore a paused Supabase project. Use list_projects to find project refs.

#### get_project_health

Get health status of a Supabase project's services. Use list_projects to find project refs.

#### list_secrets

List all secrets for a Supabase project. Secret values may be redacted. Use list_projects to find refs.

#### create_secrets

Create or update secrets for a Supabase project (bulk). Each secret needs 'name' and 'value'.

#### delete_secrets

Delete secrets from a Supabase project by name (bulk). Use list_secrets to find secret names.

#### list_snippets

List all SQL snippets accessible to the authenticated user.

#### get_snippet

Get a SQL snippet's details and content by ID. Use list_snippets to find snippet IDs.