PlanetScale

About

PlanetScale is an MCP connector that gives the Sazabi agent tools to query databases, inspect schema, and explore Insights data. PlanetScale's MCP server authenticates via OAuth with dynamic client registration. Once connected, agents can list organizations, databases, and branches, inspect table schemas, execute queries, and surface Insights recommendations. Each query uses short-lived, ephemeral credentials that are created on demand and deleted immediately after execution.

What the agent can do:

• List organizations, databases, and branches
• Inspect table schemas and database structure
• Execute read and write SQL queries
• Browse PlanetScale Insights and schema recommendations
• Access branch-level metadata and deploy requests

Prerequisites

• A PlanetScale account (Hobby or paid plan)
• Permission to authorize third-party OAuth applications in your PlanetScale organization

Set up in the dashboard

Configure connectors in the dashboard under Settings > MCP connectors.

Set up with the CLI

You can also connect PlanetScale with the Sazabi CLI (installed and authenticated — see sazabi mcp-connectors reference).

PlanetScale authenticates over OAuth, so the CLI opens a browser to complete authorization:

sazabi mcp-connectors connect planetscale

Add --read-only to restrict the connector to read-only tools, or --project-id <project> to target a specific project. In --json mode the command prints an authorization URL to open, then polls until the connection completes. Confirm the result with sazabi mcp-connectors list.

Verify

Open the connector's connection page under Settings > MCP connectors and confirm Sazabi lists the tools it discovered. Then, in a thread, ask the agent to use one of those tools and confirm it runs. If no tools appear, confirm the connection is authorized (OAuth) or the key/header is correct (token auth).

Troubleshooting

No tools discovered — Disconnect and reconnect from Settings > MCP connectors to restart the OAuth flow.

Connection shows needs attention — The authorization or key may have expired or been revoked; reconnect from Settings > MCP connectors.

Further reading