Skip to main content

Supabase

Connects to a Supabase project via its PostgREST API. An agent can query, insert, update, and delete table rows, and call Postgres functions via RPC.

Add to an agent node's tools array with _node_type: "tool-supabase". See Connector Reference — How connectors are used.

Authentication

FieldRequiredDescription
urlYesSupabase project URL (e.g. https://xxx.supabase.co).
api_keyYes (one of)API key sent as both apikey and Authorization: Bearer headers. Falls back to service_role_key, then anon_key if not set.
service_role_keyNoAlternate name for api_key, used if api_key is not set.
anon_keyNoAlternate name for api_key, used if neither api_key nor service_role_key is set.
{
"name": "supabase",
"_node_type": "tool-supabase",
"url": "https://xxxxx.supabase.co",
"api_key": "{{ secret.SUPABASE_SERVICE_ROLE_KEY }}"
}

Tools

supabase_select

Query rows from a Supabase table using PostgREST filters.

Parameters

ParameterTypeRequiredDescription
tablestringYesTable name
columnsstringNoComma-separated columns (default: *)
filterstringNoPostgREST filter (e.g. status=eq.active)
limitnumberNoMaximum rows (default 20)
orderstringNoOrder by (e.g. created_at.desc)

Returns: The raw JSON response body from PostgREST (an array of row objects).

supabase_insert

Insert a row into a Supabase table.

Parameters

ParameterTypeRequiredDescription
tablestringYesTable name
documentobjectYesObject to insert

Returns: The raw JSON response body (the inserted row representation).

supabase_update

Update rows in a Supabase table matching a filter.

Parameters

ParameterTypeRequiredDescription
tablestringYesTable name
filterstringYesPostgREST filter (e.g. id=eq.123)
documentobjectYesFields to update

Returns: The raw JSON response body (the updated row representation).

supabase_delete

Delete rows from a Supabase table matching a filter.

Parameters

ParameterTypeRequiredDescription
tablestringYesTable name
filterstringYesPostgREST filter (e.g. id=eq.123)

Returns: The raw JSON response body (the deleted row representation).

supabase_rpc

Call a Supabase database function via RPC.

Parameters

ParameterTypeRequiredDescription
functionstringYesSupabase function name
argsobjectNoFunction arguments

Returns: The raw JSON response body returned by the function.

Next