list_tables
Identify all accessible tables in a self-hosted Supabase database, organized by schema, to streamline database exploration and management tasks.
Instructions
Lists all accessible tables in the connected database, grouped by schema.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/list_tables.ts:28-69 (handler)The complete tool object for 'list_tables', including the execute handler function that queries the database for accessible tables, excluding system and Supabase internal schemas.
export const listTablesTool = { name: 'list_tables', description: 'Lists all accessible tables in the connected database, grouped by schema.', inputSchema: ListTablesInputSchema, // Use defined schema mcpInputSchema: mcpInputSchema, // Add the static JSON schema for MCP outputSchema: ListTablesOutputSchema, // Use explicit types for input and context execute: async (input: ListTablesInput, context: ToolContext) => { const client = context.selfhostedClient; // SQL query to get tables from pg_catalog and information_schema // Excludes system schemas like pg_catalog, information_schema, and Supabase internal schemas const listTablesSql = ` SELECT n.nspname as schema, c.relname as name, pgd.description as comment FROM pg_catalog.pg_class c JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace LEFT JOIN pg_catalog.pg_description pgd ON pgd.objoid = c.oid AND pgd.objsubid = 0 WHERE c.relkind = 'r' -- r = ordinary table AND n.nspname NOT IN ('pg_catalog', 'information_schema', 'pg_toast') AND n.nspname NOT LIKE 'pg_temp_%' AND n.nspname NOT LIKE 'pg_toast_temp_%' -- Exclude Supabase internal schemas AND n.nspname NOT IN ('auth', 'storage', 'extensions', 'graphql', 'graphql_public', 'pgbouncer', 'realtime', 'supabase_functions', 'supabase_migrations', '_realtime') AND has_schema_privilege(n.oid, 'USAGE') AND has_table_privilege(c.oid, 'SELECT') ORDER BY n.nspname, c.relname `; const result = await executeSqlWithFallback(client, listTablesSql, true); return handleSqlResponse(result, ListTablesOutputSchema); // Use a helper to handle response/errors }, }; - src/tools/list_tables.ts:7-11 (schema)Zod schema for the tool output: array of table objects with schema name, table name, and optional comment.
const ListTablesOutputSchema = z.array(z.object({ schema: z.string(), name: z.string(), comment: z.string().nullable().optional(), // Add comment if available })); - src/tools/list_tables.ts:14-17 (schema)Zod schema for tool input: empty object since no input parameters are required.
const ListTablesInputSchema = z.object({ // No specific input needed for listing tables // Optional: add schema filter later if needed // schema: z.string().optional().describe('Filter tables by schema name.'), }); - src/index.ts:100-100 (registration)Registration of the listTablesTool in the availableTools object, which is used to populate the MCP server's tool capabilities.
[listTablesTool.name]: listTablesTool as AppTool, - src/index.ts:11-11 (registration)Import statement for listTablesTool in the main index file.
import { listTablesTool } from './tools/list_tables.js';