Inspects the local Supabase Postgres schema and runs read-only SQL via the project MCP (list_tables, execute_sql SELECT-only, list_migrations, advisors, logs, docs). Use when debugging DB issues, exploring tables or columns, verifying data with SELECTs, or clarifying the current schema. Never use MCP to change the database; schema changes use the modifying-database skill and Supabase CLI migrations.
Usar el MCP local database del proyecto para entender el esquema, consultar datos de solo lectura y depurar. Todo el flujo es solo lectura respecto a la base de datos.
Cambios de esquema o datos persistentes: seguir el skill modifying-database (supabase migration new, editar SQL, supabase migration up). No usar el MCP para eso.
project-0-x-clone-local database (nombre visible: local database).apply_migration — no invocar. El DDL y las migraciones van por (skill ).modifying-databaseexecute_sql con cualquier sentencia que modifique estado:
CREATE, ALTER, DROP, TRUNCATE, COMMENT ON que altere objetos, etc.INSERT, UPDATE, DELETE, MERGE, UPSERT, etc.GRANT, REVOKE, COPY ... FROM hacia tablas, etc.Si hace falta cambiar la BD, parar el uso de este skill y usar (skill modifying-database)
| Herramienta | Uso |
|---|---|
list_tables | Resumen de tablas por esquema (schemas, p. ej. ["public"]). Con verbose: true: columnas, PKs y FKs. Primera opción para mapa del esquema. |
execute_sql | Solo consultas de lectura: SELECT, introspección (information_schema, pg_catalog), EXPLAIN / EXPLAIN ANALYZE sobre SELECT. Limitar filas (LIMIT) en exploración. |
list_migrations | Ver qué migraciones registra la base (estado vs archivos locales). |
list_extensions | Extensiones instaladas en Postgres. |
get_advisors | type: security o performance — avisos de Supabase (RLS, rendimiento). Incluir enlaces de remediación que devuelva la herramienta. |
get_logs | service: api, postgres, auth, storage, realtime, edge-function, branch-action — logs ~24h para debug de servicios. |
get_project_url | URL de API del proyecto (contexto de entorno). |
get_publishable_keys | Claves publicables (solo si hace falta para depuración de cliente; no exponer en logs públicos). |
No incluido aquí: generate_typescript_types altera archivos del repo; en este monorepo los tipos viven en app/src/types/database.types.ts y se actualizan a mano cuando cambie el esquema (tras migraciones, skill modifying-database).
list_tables con verbose: true en los esquemas relevantes.execute_sql con SELECT acotado.get_advisors.get_logs según el servicio implicado.search_docs con una query GraphQL válida según el esquema de la herramienta.Antes de llamar a una herramienta MCP, si hace falta confirmar parámetros, leer el descriptor JSON del tool en la carpeta mcps del proyecto Cursor (servidor local database), p. ej. tools/list_tables.json — list_tables exige schemas y verbose.