Why do I need to use the service role key instead of the safe public anon key?

The MCP integration operates inherently as an administration module properly securely autonomously. Utilizing the `service_role` actively gracefully securely circumvents logical Row Level Security settings globally, empowering correct system manipulation properly dynamically successfully without error friction organically.

Is there a safety measure preventing unintended whole table destructive deletions?

Yes. Commands mutating or destroying rows, such as accurately calling `db_delete`, rigorously mandate explicit logical matching definitions (like exact ID tracking) seamlessly inherently systematically mitigating risk effectively fully locally organically efficiently properly.

Can the AI call custom PostgreSQL functions (RPC)?

Yes. Use `db_rpc` to invoke any server-side PL/pgSQL function by name, passing JSON arguments. This lets the AI trigger stored procedures, computed views, or custom business logic directly.

Supabase MCP Server for Google ADK 10 tools — connect in under 2 minutes

Name: Supabase
Availability: InStock
Author: Vinkius

google.github.io/adk-docs/tools/mcp-tools

Built by Vinkius GDPR 10 Tools SDK

Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add Supabase as an MCP tool provider through the Vinkius and your ADK agents can call every tool with full schema introspection.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
    StreamableHTTPConnectionParams,
)

# Your Vinkius token — get it at cloud.vinkius.com
mcp_tools = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    )
)

agent = Agent(
    model="gemini-2.5-pro",
    name="supabase_agent",
    instruction=(
        "You help users interact with Supabase "
        "using 10 available tools."
    ),
    tools=[mcp_tools],
)

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Supabase MCP Server

Integrate the comprehensive backend infrastructure of Supabase straight into your conversational LLM workflows. By securely authenticating with your service_role key, your AI assistant bypasses row-level security constraints, operating as a fully-privileged database administrator. Query rows, invoke complex PL/pgSQL functions via RPC, evaluate the authenticated user roster, and audit your active storage buckets all through simple natural language commands, accelerating debugging and environment iterations without leaving the terminal.

Google ADK natively supports Supabase as an MCP tool provider — declare the Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 10 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.

What you can do

Database Interactions — Actively query datasets using db_select, seamlessly add new rows executing db_insert, and modify existing data structures applying db_update or db_delete.
Custom Functional Logic — Invoke pre-compiled database procedures and PL/pgSQL functions securely utilizing db_rpc with dynamic JSON arguments.
Authentication Tracking — Audit your userbase and confirm authentication statuses instantly fetching native rosters through list_auth_users.
Storage Diagnostics — Inspect configured object storage containers mapping file architectures securely invoking list_storage_buckets.

The Supabase MCP Server exposes 10 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Supabase to Google ADK via MCP

Follow these steps to integrate the Supabase MCP Server with Google ADK.

Install Google ADK

Run pip install google-adk

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Create the agent

Save the code above and integrate into your ADK workflow

Explore tools

The agent will discover 10 tools from Supabase via MCP

Why Use Google ADK with the Supabase MCP Server

Google ADK provides unique advantages when paired with Supabase through the Model Context Protocol.

Google ADK natively supports MCP tool servers — declare a tool provider and the framework handles discovery, validation, and execution

Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with Supabase

Production-ready features like session management, evaluation, and deployment come built-in — not bolted on

Seamless integration with Google Cloud services means you can combine Supabase tools with BigQuery, Vertex AI, and Cloud Functions

Supabase + Google ADK Use Cases

Practical scenarios where Google ADK combined with the Supabase MCP Server delivers measurable value.

Enterprise data agents: ADK agents query Supabase and cross-reference results with internal databases for comprehensive analysis

Multi-modal workflows: combine Supabase tool responses with Gemini's vision and language capabilities in a single agent

Automated compliance checks: schedule ADK agents to query Supabase regularly and flag policy violations or configuration drift

Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including Supabase

Supabase MCP Tools for Google ADK (10)

These 10 tools become available when you connect Supabase to Google ADK via MCP:

db_count

Useful for pagination and analytics. Count rows in a database table with optional filters

db_delete

A match_query is mandatory. This action is irreversible. Delete rows from a database table

db_insert

Provide the payload as a JSON string. Insert a new row into a database table

db_rpc

Provide the function name and optional JSON arguments. Execute a Supabase Postgres Function (RPC)

db_select

For filters, use match_query (e.g. "id=eq.1"). Defaults to 50 rows. Query records from any PostgreSQL database table using PostgREST syntax

db_update

A match_query is required to target specific rows (e.g. "id=eq.123"). Update existing rows in a database table

get_auth_user

Get detailed information about a specific authenticated user

list_auth_users

List authenticated users from Supabase Auth

list_storage_buckets

List all available storage buckets

list_storage_files

List files inside a storage bucket

Example Prompts for Supabase in Google ADK

Ready-to-use prompts you can give your Google ADK agent to start working with Supabase immediately.

"Verify the 'inventory_products' table sequentially effectively correctly querying all products labeled 'out-of-stock'."

"Trigger the custom stored procedure 'restock_items' using `db_rpc` to replenish the inventory of IDs 12 and 15 natively."

"Check all registered accounts dynamically applying `list_auth_users` for recent logins natively securely."

Troubleshooting Supabase MCP Server with Google ADK

Common issues when connecting Supabase to Google ADK through the Vinkius, and how to resolve them.

McpToolset not found

Update: pip install --upgrade google-adk

Supabase + Google ADK FAQ

Common questions about integrating Supabase MCP Server with Google ADK.

How does Google ADK connect to MCP servers?

Import the MCP toolset class and pass the server URL. ADK discovers and registers all tools automatically, making them available to your agent's tool-use loop.

Can ADK agents use multiple MCP servers?

Yes. Declare multiple MCP tool providers in your agent configuration. ADK merges all tool schemas and the agent can call tools from any server in a single turn.

Which Gemini models work best with MCP tools?

Gemini 2.0 Flash and Pro models both support function calling required for MCP tools. Flash is recommended for latency-sensitive use cases, Pro for complex reasoning.