Get started

Supabase Read for AI agents

This read-only companion to Supabase lets an agent inspect a project's database, schemas, logs, branches, and Edge Functions without making any changes. Connect it once through Arc0, and your agent, or Claude, ChatGPT and Cursor, can use it through one MCP endpoint, limited to what each user approved.

Connect Supabase ReadSee the 21 actions ↓
Databases and spreadsheetsOAuth 2.0 (MCP)MCP + RESTsupabase.com
AUDIT LOG · SUPABASE READPOLICY: acme-support
09:41:07 · claude · u_8f2read
supabase_read.list_tables
List tables✓ allowed · 212ms
09:41:08 · claude · u_8f2read
supabase_read.get_cost
Get cost✓ allowed · 164ms
09:41:09 · claude · u_8f2write
supabase_read.execute_sql
Execute sql✓ approved · approved by user
EVERY SUPABASE READ CALL, ON THE RECORD
01 · USE CASES

What agents do in Supabase Read.

01

List tables in a schema

List the tables in a project's database schema so a developer can see the current structure.

02

Query logs for recent errors

Search project logs for recent errors, a safe read-only step before deciding what to fix.

03

Check cost before running a query

Get the estimated cost of a query and require confirmation before running anything that could be expensive.

02 · ACTIONS

21 Supabase Read actions, graded by risk.

Every Supabase Read action is tagged read, write or destructive, so one policy covers the whole app and new actions inherit the right default.

read

18

Look things up. Allowed by default.

  • supabase_read.get_cost
    Get cost
  • supabase_read.query_logs
    Query logs
  • supabase_read.get_project
    Get project
  • supabase_read.list_tables
    List tables
  • supabase_read.search_docs
    Search docs
  • supabase_read.get_advisors
    Get advisors
  • supabase_read.list_branches
    List branches
  • supabase_read.list_projects
    List projects
  • supabase_read.get_project_url
    Get project url
  • supabase_read.list_extensions
    List extensions
  • supabase_read.list_migrations
    List migrations
  • supabase_read.get_organization
    Get organization
  • supabase_read.get_edge_function
    Get edge function
  • supabase_read.get_storage_config
    Get storage config
  • supabase_read.list_organizations
    List organizations
  • supabase_read.list_edge_functions
    List edge functions
+ 2 MORE

write

3

Create and change things. Allow, or ask the user first.

  • supabase_read.execute_sql
    Execute sql
  • supabase_read.confirm_cost
    Confirm cost
  • supabase_read.generate_typescript_types
    Generate typescript types

destructive

0

Delete, cancel or archive. Ask first, or deny outright.

  • No destructive actions.
03 · HOW IT WORKS

Supabase Read in three steps.

  1. 01Your users connect Supabase ReadThey sign in to Supabase Read on Arc0 Connect, under your brand, and approve the access you ask for.
  2. 02You set the rulesReads run, and writes like “execute sql” can wait for the user to approve.
  3. 03Any agent can actYour agent calls Supabase Read through the Arc0 SDK or MCP, and so can Claude, ChatGPT and Cursor. Every call lands on the audit log.
POLICY.TS
await arc0.policies.set('supabase_read', {
  read: 'allow',
  write: 'ask',        // execute_sql
  destructive: 'deny',  
})

# Claude Code: the same connection, one URL
$ claude mcp add --transport http arc0 \
    https://mcp.arc0.ai/u/u_8f2
04 · AUTH AND DATA

How Supabase Read connects.

Supabase Read runs its own MCP server behind OAuth. Arc0 registers the client, users approve access on Arc0 Connect, and your agent reaches Supabase Read through the same endpoint, policies and audit log as every other app.

The same Supabase Read connection serves your agent over MCP and your own backend over REST and the proxy, so a user connects once. How Arc0 handles credentials →

AUTH
OAuth 2.0 (MCP)
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · WORKS WITH

Use Supabase Read from any agent.

Claude
ChatGPT
Cursor
Codex
VS Code
OpenAI Agents SDK
Claude Agent SDK
Vercel AI SDK
Mastra
LangGraph
06 · RELATED

More databases and spreadsheets apps.

Google Sheets58 actionsExcel55 actionsSnowflake17 actionsAnyDB9 actionsGigasheet150 actionsNeon110 actionsGoogle BigQuery63 actionsNocoDB28 actions
ALL DATABASES AND SPREADSHEETS APPS →
07 · FAQ

Supabase Read and Arc0, answered.

Q01

Can I use Supabase Read with Claude, ChatGPT or Cursor?

Yes. Connect Supabase Read to Arc0 once, then add your Arc0 MCP URL to Claude, ChatGPT, Cursor, Claude Code or any other remote-MCP client. Each assistant only gets the Supabase Read actions you allow.

Q02

How do users connect Supabase Read?

Supabase Read runs its own MCP server behind OAuth. Arc0 registers the client, users approve access on Arc0 Connect, and your agent reaches Supabase Read through the same endpoint, policies and audit log as every other app.

Q03

Which Supabase Read actions can my agent take?

21 in total: 18 read, 3 write and 0 destructive, such as “execute sql”. Your policies decide which of them each agent may call.

Q04

Can I make my agent read-only in Supabase Read?

Yes. Allow read actions and deny writes in the Supabase Read policy. Your agent can still look things up, and any write it attempts is blocked and logged.

Q05

Can my own backend call Supabase Read too?

Yes. The same Supabase Read connection is available over REST and through the Arc0 proxy, so your product and your agent share one connection per user.

Get started

Plug Supabase Read into your agent.

Your users connect Supabase Read once, under your brand. Your agent gets 21 actions behind your policies, with every call on the record.

Connect Supabase ReadBrowse all apps →

Free to build · MCP + REST · Audit log on every plan