Skip to main content
Twin ID: supabase Covers orgs, projects, database operations, edge functions, and branching. Uses PGlite (embedded Postgres) instead of an in-memory state engine, so SQL execution is real.

Available tools

Documentation

ToolDescription
search_docsSearch the Supabase documentation using GraphQL

Organizations & Projects

ToolDescription
list_organizationsLists all organizations the user is a member of
get_organizationGets details for an organization including subscription plan
list_projectsLists all Supabase projects for the user
get_projectGets details for a Supabase project
create_projectCreates a new Supabase project
pause_projectPauses a Supabase project
restore_projectRestores a paused Supabase project

Cost Management

ToolDescription
get_costGets the cost of creating a new project or branch
confirm_costAsk the user to confirm their understanding of cost

Database

ToolDescription
execute_sqlExecutes raw SQL in the Postgres database
list_tablesLists all tables in one or more schemas
list_extensionsLists all extensions in the database
apply_migrationApplies a migration to the database (DDL operations)
list_migrationsLists all migrations in the database
generate_typescript_typesGenerates TypeScript types for a project

Keys & URLs

ToolDescription
get_project_urlGets the API URL for a project
get_publishable_keysGets all publishable API keys for a project

Monitoring

ToolDescription
get_logsGets logs for a Supabase project by service type
get_advisorsGets advisory notices for security and performance

Edge Functions

ToolDescription
list_edge_functionsLists all Edge Functions in a project
get_edge_functionRetrieves file contents for an Edge Function
deploy_edge_functionDeploys an Edge Function to a project

Branches

ToolDescription
create_branchCreates a development branch on a project
list_branchesLists all development branches
delete_branchDeletes a development branch
merge_branchMerges migrations and edge functions from a branch to production
reset_branchResets migrations of a development branch
rebase_branchRebases a development branch on production

Seeds

SeedDescription
emptyEmpty database with default schema
small-projectDatabase with tables, sample data, and migrations
edge-casesDatabase with edge case scenarios for testing error handling

Notes

  • Seeds are SQL files loaded directly into the embedded database, not JSON.
  • apply_migration is disabled in read-only mode (--read-only=true).
  • execute_sql warns that returned data may be untrusted, matching the real server.
  • In hosted sessions, MCP is exposed over HTTPS endpoints (for example https://<session>.twins.archal.ai/supabase/mcp).