supabase

Supabase is a powerful open-source backend-as-a-service platform that provides developers with a suite of tools to build, scale, and manage modern applications. Supabase offers a fully managed PostgreSQL database, robust authentication, instant RESTful and GraphQL APIs, real-time subscriptions, file storage, and edge functions—all accessible through a unified and developer-friendly interface. Its open-source nature and compatibility with popular frameworks make it a compelling alternative to Firebase, with the added benefit of SQL flexibility and transparency.

Why Supabase?

• Instant APIs: Every table and view in your database is instantly available via REST and GraphQL endpoints, making it easy to build data-driven applications without writing custom backend code.

• Real-time Data: Supabase enables real-time subscriptions, allowing your apps to react instantly to changes in your database.

• Authentication & Authorization: Built-in user management with support for email, OAuth, SSO, and more, plus row-level security for granular access control.

• Storage: Securely upload, serve, and manage files with built-in storage that integrates seamlessly with your database.

• Edge Functions: Deploy serverless functions close to your users for low-latency custom logic.

Using Supabase in Agent Forge

Agent Forge’s Supabase integration makes it effortless to connect your agentic workflows to your Supabase projects. With just a few configuration fields—your Project ID, Table name, and Service Role Secret—you can securely interact with your database directly from your Agent Forge blocks. The integration abstracts away the complexity of API calls, letting you focus on building logic and automations.

Key benefits of using Supabase in Agent Forge:

• No-code/low-code database operations: Query, insert, update, and delete rows in your Supabase tables without writing SQL or backend code.

• Flexible querying: Use PostgREST filter syntax to perform advanced queries, including filtering, ordering, and limiting results.

• Seamless integration: Easily connect Supabase to other tools and services in your workflow, enabling powerful automations such as syncing data, triggering notifications, or enriching records.

• Secure and scalable: All operations use your Supabase Service Role Secret, ensuring secure access to your data with the scalability of a managed cloud platform.

Whether you’re building internal tools, automating business processes, or powering production applications, Supabase in Agent Forge provides a fast, reliable, and developer-friendly way to manage your data and backend logic—no infrastructure management required. Simply configure your block, select the operation you need, and let Agent Forge handle the rest.

Usage Instructions

Integrate with Supabase to manage your database, authentication, storage, and more. Query data, manage users, and interact with Supabase services directly.

Where to Get Your Supabase API Keys

To get your Supabase API keys, you need to navigate to your project settings in the Supabase dashboard.

Here is the step-by-step process:

1

Log in to your Supabase account

Go to the Supabase Dashboard and sign in.

2

Select Your Project

Choose the specific project you need the keys for from your main dashboard.

3

Navigate to API Settings

In the left-hand sidebar, go to Project Settings > API.

4

Retrieve Your Keys

On this page, you will find three critical pieces of information:

• service_role (secret) key: A highly privileged key used for server-side operations.

• anon (public) key: Used for client-side applications.

• Project URL

Tools

supabase_query

Get data from a Supabase table

Input

Parameter	Type	Required	Description
projectId	string	Yes	Your Supabase project ID (e.g., jdrkgepadsdopsntdlom)
table	string	Yes	The name of the Supabase table to query
filter	string	No	PostgREST filter (e.g.,
orderBy	string	No	Column to order by (add DESC for descending)
limit	number	No	Maximum number of rows to return
apiKey	string	Yes	Your Supabase service role secret key

Output

Parameter	Type	Description
message	string	Operation message
results	json	Query results

supabase_insert

Insert data into a Supabase table

Input

Parameter	Type	Required	Description
projectId	string	Yes	Your Supabase project ID (e.g., jdrkgepadsdopsntdlom)
table	string	Yes	The name of the Supabase table to insert data into
data	any	Yes	The data to insert
apiKey	string	Yes	Your Supabase service role secret key

Output

Parameter	Type	Description
message	string	Operation message
results	json	Query results

supabase_get_row

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

Input

Parameter	Type	Required	Description
projectId	string	Yes	Your Supabase project ID (e.g., jdrkgepadsdopsntdlom)
table	string	Yes	The name of the Supabase table to query
filter	string	Yes	PostgREST filter to find the specific row (e.g.,
apiKey	string	Yes	Your Supabase service role secret key

Output

Parameter	Type	Description
message	string	Operation message
results	json	Query results

supabase_update

Update rows in a Supabase table based on filter criteria

Input

Parameter	Type	Required	Description
projectId	string	Yes	Your Supabase project ID (e.g., jdrkgepadsdopsntdlom)
table	string	Yes	The name of the Supabase table to update
filter	string	Yes	PostgREST filter to identify rows to update (e.g.,
data	object	Yes	Data to update in the matching rows
apiKey	string	Yes	Your Supabase service role secret key

Output

Parameter	Type	Description
message	string	Operation message
results	json	Query results

supabase_delete

Delete rows from a Supabase table based on filter criteria

Input

Parameter	Type	Required	Description
projectId	string	Yes	Your Supabase project ID (e.g., jdrkgepadsdopsntdlom)
table	string	Yes	The name of the Supabase table to delete from
filter	string	Yes	PostgREST filter to identify rows to delete (e.g.,
apiKey	string	Yes	Your Supabase service role secret key

Output

Parameter	Type	Description
message	string	Operation message
results	json	Query results

Notes

• Category: tools

• Type: supabase