Home / Servers / Supabase Management API / v1_run_a_query
Run sql query
An MCP tool from the Supabase Management API server, hosted on mcp.hjlabs.in.
Run sql query This is an **experimental** endpoint. It is subject to change or removal in future versions. Use it with caution, as it may not remain supported or stable. This endpoint is currently in its **Beta**… [POST /v1/projects/{ref}/database/query]
Name on the gateway: supabase_api__v1_run_a_query · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
ref required | string | Project ref |
query required | string | |
parameters | array | |
read_only | boolean |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "supabase_api__v1_run_a_query",
"arguments": {
"ref": "…",
"query": "…"
}
}Or connect the Supabase Management API server directly, which lists 167 tools including this one:
claude mcp add --transport http hj-supabase-api https://mcp.hjlabs.in/mcp/supabase-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the run sql query tool with ref set to ….