Supabase MCP Server — Hosted for Any AI Agent
MCP Server language Hosted language PublicQuery Postgres tables, manage storage buckets, and interact with your Supabase backend — AI-native database access.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"supabase": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-supabase",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the list_tables tool to list all tables in the supabase database”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
The Supabase MCP server gives AI agents access to your Supabase project — querying Postgres, managing tables, and inspecting your database. Hosted on Aerostack as a single URL for any MCP agent, it lets assistants run SQL, explore schemas, and operate your backend through natural language.
description Overview
mcp-supabase — Supabase MCP Server
Query your Supabase PostgreSQL database and manage storage buckets from your AI agents.
Supabase is the open-source Firebase alternative built on PostgreSQL — used by thousands of startups and teams as their primary application database. This MCP server gives your AI agents direct read/write access to your Supabase project: selecting, inserting, updating, and deleting rows, calling stored procedures, and listing files in storage buckets — all through natural language.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-supabase
What You Can Do
- Query any table in your Supabase database with filters to pull live app data into agent workflows
- Insert or update rows to write results back to your database as part of automation pipelines
- Call stored procedures (RPC functions) to execute complex business logic already defined in your database
- List files in Supabase storage buckets to audit assets or chain into file processing workflows
Available Tools
| Tool | Description |
|---|---|
list_tables |
Introspect available tables and their columns |
select |
Run a SELECT query on a table with optional filters |
insert |
Insert one or more rows into a table |
update |
Update rows matching a filter condition |
delete |
Delete rows matching a filter condition |
rpc |
Call a Supabase database function (stored procedure) |
storage_list |
List files in a storage bucket |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
SUPABASE_URL |
Yes | Your Supabase project URL | app.supabase.com → Your Project → Settings → API → copy Project URL |
SUPABASE_ANON_KEY |
Yes | Supabase anonymous/public key | Same page → copy anon public key under Project API keys |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Supabase" and click Add to Workspace
- Add
SUPABASE_URLandSUPABASE_ANON_KEYunder Project → Secrets
Once added, every AI agent in your workspace can call Supabase tools automatically — no per-user setup needed.
Example Prompts
"List all tables in my Supabase database and describe their columns"
"Select all rows from the orders table where status is pending, ordered by created_at descending"
"Insert a new row into the notifications table with user_id 42 and message: Your report is ready"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-supabase \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-SUPABASE-URL: https://yourproject.supabase.co' \
-H 'X-Mcp-Secret-SUPABASE-ANON-KEY: your-anon-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_tables","arguments":{}}}'
License
MIT
terminal Tools (7)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
list_tables #1 List all tables in the Supabase database
select #2 Query rows from a Supabase table with optional filters, ordering, and pagination
insert #3 Insert one or more rows into a Supabase table
update #4 Update rows in a Supabase table matching a filter
delete #5 Delete rows from a Supabase table matching a filter
rpc #6 Call a Supabase RPC (PostgreSQL function)
storage_list #7 List files in a Supabase Storage bucket
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-supabase
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in Database
Browse Database MCPs →Airtable
by @aerostack
Turn your Airtable bases into an AI-queryable database — create, update, search, and analyze records with natural language.
Notion Workspace
by @aerostack
Pages, databases, blocks, search via Notion's official MCP
Mongodb
by @aerostack
Query collections, insert documents, and run aggregation pipelines on your MongoDB Atlas database — AI-native document database access.
Redis
by @aerostack
Get, set, and manage keys, hashes, and lists in your Upstash Redis database — AI-native key-value store access.
Turso
by @aerostack
Execute SQL queries, manage tables, and interact with your Turso (LibSQL) edge database — AI-native SQLite at the edge.
Dynamodb
by @aerostack
Query, put, update, delete, and scan items in Amazon DynamoDB tables — AI-native NoSQL database access for any agent.
Frequently asked questions
What is the Supabase MCP server and what can it do? +
The Supabase MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `list_tables`, `select`, `insert`, `update`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Supabase MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Supabase MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Supabase MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Supabase MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-supabase": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-supabase"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Supabase MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-supabase", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-supabase"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Supabase MCP require authentication? +
Yes. Supabase requires authentication. Check the MCP's documentation for the required credentials.