PlanetScale

Overview

Connect PlanetScale so AI clients can list organizations, databases, and branches through the PlanetScale API.

stackgate.ai stores your service token ID and token encrypted and calls https://api.planetscale.com/v1 on your behalf. Tool results are returned to your AI client for that request.

This integration manages PlanetScale platform resources. It does not run SQL against your data. For query execution, use PlanetScale's own hosted MCP.

Prerequisites

• A PlanetScale organization
• A stackgate.ai account

Getting credentials

1. Sign in to the PlanetScale dashboard.
2. Open Settings → Service tokens and create a new service token.
3. Copy the ID and token once. The token is not shown again.
4. Grant organization access: at least read_organization.
5. Grant database access for each database (or all databases): at least read_database and read_branch.
6. In stackgate.ai, open My Integrations → PlanetScale, paste the ID and token, optionally set a default organization, and click Connect & enable.
7. After connect, use Edit tool access if you want a smaller tool allowlist.

Treat the token like a password. Rotate or delete it in PlanetScale if it is exposed.

See the service token documentation for access permissions.

Using with AI clients

• Dedicated endpoint: POST /mcp/planetscale with a Sanctum bearer token
• Private gateway: one config for all integrations - use planetscale__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Suggested workflow

1. list_organizations - confirm the token and note organization names.
2. list_databases / get_database - find the database name.
3. list_branches / get_branch - inspect production and development branches.

If you set a default organization, tools can omit the organization argument.

Troubleshooting

• 422 integration not configured - paste a service token ID and token in My Integrations.
• 401 Unauthorized - regenerate the service token in PlanetScale and update My Integrations. The full token is shown only once.
• 403 Forbidden - the token is missing organization or database access. Add read_organization, read_database, and read_branch on the token.
• Empty organization or database lists - the token may have no grants for those resources.
• 429 Too many requests - the PlanetScale API allows 600 requests per minute. Wait and retry. Reduce parallel tool calls.
• SQL or query tools missing - this hub integration does not execute SQL. Use PlanetScale's hosted MCP for query execution.