Cloud provider

PlanetScale

Connect your PlanetScale organization to give agents visibility into your databases and branches. Agents can track schema changes, monitor branch state, and correlate database activity with the rest of your infrastructure.

Connect

Connect PlanetScale from the terminal. Pass --help for the flags PlanetScale accepts, plus --no-browser for headless environments.

Terminal

polylane cloud connect --provider planetscale

OAuth authorization, or a service token from your PlanetScale organization settings.

PlanetScale connects via OAuth: click Connect with PlanetScale, authorize read access on PlanetScale, and you're redirected back with syncing already started. Tokens are encrypted before they are stored, and the agent never sees them.

Service token alternative

If you prefer a long-lived credential, connect with a service token instead:

Open PlanetScale, go to your organization's Settings → Service tokens.
Click Create service token and copy both the token ID and the token.
Grant the token read access to the organization and its databases (e.g. read_databases, read_branches).
Paste the token ID and token into Polylane.
Polylane validates the token and starts syncing.

Polylane discovers your databases and their branches, including state, plan, region, and schema activity.

Troubleshooting

"Invalid service token" error

Both the token ID and the token are required; the token alone cannot authenticate.
Check that the token has not been deleted in PlanetScale's settings.
Make sure the token has organization read access.

Missing resources

PlanetScale can take a few minutes to sync everything.
Trigger a manual Sync from the account header to refresh.

Disconnecting

Disconnect the account in Polylane, then delete the service token from your PlanetScale organization settings.

Tools

Operations agents can perform in threads and automations.

planetscaleApi

Call any PlanetScale REST API endpoint that lacks a dedicated tool

planetscaleGetQueryInsights

Get PlanetScale Query Insights for a database branch: top queries, query errors, or latency anomalies

Supported resources

Resource types that show up in your infrastructure graph.

Database

Database Branch

Automation triggers

Events from PlanetScale that can start an automation.

Cloud Account Connected

Fires once when a user connects a new cloud account to the workspace.

Cloud Account Synced

Fires each time a cloud account finishes a full or incremental sync.

Infra Node Created

Fires once per new infrastructure resource discovered during a cloud sync.

Automation templates

Pre-built automations that use PlanetScale. Open one to see its trigger, instructions, and actions.

Daily PlanetScale infrastructure audit

Run a daily audit of your PlanetScale observability setup and flag gaps in monitoring

Back to integrations