runelay+SupabaseIntegration · OAuth login
Supabase on Runelay, an open source MCP gateway
Supabase's official MCP server, shared by every agent. Your agent inspects the schema, runs SQL, applies migrations and checks logs and advisors without you copying a key into each tool.
Supabase's own MCP server
The catalog entry points at mcp.supabase.com/mcp, the hosted server Supabase runs. It works across the projects of the account you log in with.
Supabase documents two URL options, read_only=true to run every query as a read-only Postgres user and project_ref to scope the server to one project. To use them, add that URL as a custom connector.
What your agent can do in Supabase
- Database.
list_tables,list_extensions,list_migrations,apply_migrationandexecute_sql. - Debugging. Read logs with
query_logsand security and performance hints withget_advisors. - Development.
get_project_url,get_publishable_keysandgenerate_typescript_types. - Edge Functions.
list_edge_functions,get_edge_functionanddeploy_edge_function. - Account. List and read projects and organizations, create, pause or restore a project, with
get_costandconfirm_costbefore anything billable. - Docs.
search_docssearches the Supabase documentation.
Try asking
- “List the tables in my staging project and show which ones have no primary key.”
- “Write a migration that adds an index on orders.customer_id and apply it.”
- “What do the advisors say about security in my production project?”
How it signs in
- OAuth with dynamic client registration. Runelay opens the Supabase login; no personal access token or OAuth app to create.
- Account-wide by default. The catalog URL reaches every project of the account, with write access. Use the read-only or project-scoped URL above when that is too much.
What this connection does
Database, tables, migrations and logs. Runelay connects to the Supabase remote MCP server at https://mcp.supabase.com/mcp and puts its tools behind your own endpoint.
Agents find them with search_tools and run them with call_tool, so the Supabase tool list is not loaded into context until it is needed.
Connect Supabase
Open the connectors in the panel
Pick Supabase from the catalog.
Log in once
A browser tab opens on Supabase. Approve the access and close it.
Done
The token is stored encrypted on your server and refreshed by Runelay. Every agent with a Runelay key can use the connection.
Use Supabase in your agents
Agents do not need a Supabase entry of their own. Point each one at Runelay and Supabase is there.
Questions
How do I keep the agent from changing my database?
Add mcp.supabase.com/mcp?read_only=true as a custom connector. Supabase then runs every query as a read-only Postgres user.
Can I limit it to one project?
Yes, with the project_ref parameter in the URL. In that mode the account tools, such as listing and creating projects, are turned off.
Does it handle branches?
Supabase lists branching tools such as create_branch and merge_branch as experimental, and they need a paid plan.