Mandala
Tools

Supabase

Use Supabase database

Usage Instructions

Integrate Supabase into the workflow. Supports database operations (query, insert, update, delete, upsert), full-text search, RPC functions, row counting, vector search, and complete storage management (upload, download, list, move, copy, delete files and buckets).

Tools

supabase_query

Query data from a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to query
schemastringNoDatabase schema to query from (default: public). Use this to access tables in other schemas.
filterstringNoPostgREST filter (e.g., "id=eq.123")
orderBystringNoColumn to order by (add DESC for descending)
limitnumberNoMaximum number of rows to return
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records returned from the query

supabase_insert

Insert data into a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to insert data into
schemastringNoDatabase schema to insert into (default: public). Use this to access tables in other schemas.
dataarrayYesThe data to insert (array of objects or a single object)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of inserted records

supabase_get_row

Get a single row from a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to query
schemastringNoDatabase schema to query from (default: public). Use this to access tables in other schemas.
filterstringYesPostgREST filter to find the specific row (e.g., "id=eq.123")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray containing the row data if found, empty array if not found

supabase_update

Update rows in a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to update
schemastringNoDatabase schema to update in (default: public). Use this to access tables in other schemas.
filterstringYesPostgREST filter to identify rows to update (e.g., "id=eq.123")
dataobjectYesData to update in the matching rows
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of updated records

supabase_delete

Delete rows from a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to delete from
schemastringNoDatabase schema to delete from (default: public). Use this to access tables in other schemas.
filterstringYesPostgREST filter to identify rows to delete (e.g., "id=eq.123")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of deleted records

supabase_upsert

Insert or update data in a Supabase table (upsert operation)

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to upsert data into
schemastringNoDatabase schema to upsert into (default: public). Use this to access tables in other schemas.
dataarrayYesThe data to upsert (insert or update) - array of objects or a single object
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of upserted records

supabase_count

Count rows in a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to count rows from
schemastringNoDatabase schema to count from (default: public). Use this to access tables in other schemas.
filterstringNoPostgREST filter (e.g., "status=eq.active")
countTypestringNoCount type: exact, planned, or estimated (default: exact)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
countnumberNumber of rows matching the filter

Perform full-text search on a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to search
schemastringNoDatabase schema to search in (default: public). Use this to access tables in other schemas.
columnstringYesThe column to search in
querystringYesThe search query
searchTypestringNoSearch type: plain, phrase, or websearch (default: websearch)
languagestringNoLanguage for text search configuration (default: english)
limitnumberNoMaximum number of rows to return
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records matching the search query

Perform similarity search using pgvector in a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the PostgreSQL function that performs vector search (e.g., match_documents)
queryEmbeddingarrayYesThe query vector/embedding to search for similar items
matchThresholdnumberNoMinimum similarity threshold (0-1), typically 0.7-0.9
matchCountnumberNoMaximum number of results to return (default: 10)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records with similarity scores from the vector search. Each record includes a similarity field (0-1) indicating how similar it is to the query vector.

supabase_rpc

Call a PostgreSQL function in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the PostgreSQL function to call
paramsobjectNoParameters to pass to the function as a JSON object
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsjsonResult returned from the function

supabase_storage_upload

Upload a file to a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path where the file will be stored (e.g., "folder/file.jpg")
fileContentstringYesThe file content (base64 encoded for binary files, or plain text)
contentTypestringNoMIME type of the file (e.g., "image/jpeg", "text/plain")
upsertbooleanNoIf true, overwrites existing file (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectUpload result including file path and metadata

supabase_storage_download

Download a file from a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file to download (e.g., "folder/file.jpg")
fileNamestringNoOptional filename override
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files

supabase_storage_list

List files in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringNoThe folder path to list files from (default: root)
limitnumberNoMaximum number of files to return (default: 100)
offsetnumberNoNumber of files to skip (for pagination)
sortBystringNoColumn to sort by: name, created_at, updated_at (default: name)
sortOrderstringNoSort order: asc or desc (default: asc)
searchstringNoSearch term to filter files by name
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of file objects with metadata

supabase_storage_delete

Delete files from a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathsarrayYesArray of file paths to delete (e.g., ["folder/file1.jpg", "folder/file2.jpg"])
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of deleted file objects

supabase_storage_move

Move a file within a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fromPathstringYesThe current path of the file (e.g., "folder/old.jpg")
toPathstringYesThe new path for the file (e.g., "newfolder/new.jpg")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectMove operation result

supabase_storage_copy

Copy a file within a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fromPathstringYesThe path of the source file (e.g., "folder/source.jpg")
toPathstringYesThe path for the copied file (e.g., "folder/copy.jpg")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectCopy operation result

supabase_storage_create_bucket

Create a new storage bucket in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the bucket to create
isPublicbooleanNoWhether the bucket should be publicly accessible (default: false)
fileSizeLimitnumberNoMaximum file size in bytes (optional)
allowedMimeTypesarrayNoArray of allowed MIME types (e.g., ["image/png", "image/jpeg"])
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectCreated bucket information

supabase_storage_list_buckets

List all storage buckets in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of bucket objects

supabase_storage_delete_bucket

Delete a storage bucket in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the bucket to delete
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectDelete operation result

supabase_storage_get_public_url

Get the public URL for a file in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file (e.g., "folder/file.jpg")
downloadbooleanNoIf true, forces download instead of inline display (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
publicUrlstringThe public URL to access the file

supabase_storage_create_signed_url

Create a temporary signed URL for a file in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file (e.g., "folder/file.jpg")
expiresInnumberYesNumber of seconds until the URL expires (e.g., 3600 for 1 hour)
downloadbooleanNoIf true, forces download instead of inline display (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
signedUrlstringThe temporary signed URL to access the file

Notes

  • Category: tools
  • Type: supabase
Supabase