PlanetScale CLI

The pscale CLI for PlanetScale MySQL and PostgreSQL databases: branches, deploy requests, SQL and diagnostics, with an agent guide

CLIHigh risk

planetscale/cli

Install

brew install planetscale/tap/pscale

macOS. Some commands also need brew install mysql-client@8.4.

This is third-party code. Review the repository files before installing.

What it does

pscale manages PlanetScale databases from the terminal: organizations, databases, schema branches, deploy requests for Vitess migrations, access roles and passwords, and backups. The sql and shell commands run queries, while insights, inspect and metrics help with slow or locked databases. For agents the CLI prints a guide with pscale agent-guide and an installable skill file with pscale --skill, and every command supports JSON output. For MCP clients PlanetScale offers a separate hosted MCP server.

Who it is for. For developers and DevOps engineers who run databases on PlanetScale and want an agent to handle them.

Good fit when

  • The agent should create a database branch and ship a migration via a deploy request
  • You need to find out why a database is slow or locking
  • You want to automate PlanetScale in scripts or GitHub Actions

Not a fit when

  • Your databases are not on PlanetScale
  • Your client only speaks MCP: the hosted PlanetScale MCP server fits better

Example request

Create an add-orders-index branch in the shop database and prepare a deploy request with the new index

Limitations

Requires a PlanetScale account, and the service is paid. Some commands need a MySQL client in PATH, and many commands work with only one engine. Availability and payment from Russia are unverified.

How to disable. Remove pscale with your package manager, for example brew uninstall pscale, and delete the skill file from the agent's skills folder if you added it.

Security check

  • Changes schema and data in production databases
  • Handles passwords and service tokens

README in short

The README lists install options: Homebrew, scoop, deb and rpm packages, AUR, binaries and a Docker image. It also points to a GitHub Action and the hosted MCP server. For agents it mentions pscale agent-guide, pscale --skill, AGENTS.md and the planetscale/skills pack.

FAQ

Is there an MCP server?

The README points MCP clients to the hosted PlanetScale MCP server in the docs; the CLI itself is for direct shell automation.

Where are change safety workflows?

In the separate planetscale/skills pack that the agent guide links to.

Editors’ pick

Official skills and agents from the .NET team: performance, MSBuild, NuGet, upgrades, testing, ASP.NET Core, Blazor and MAUI

PluginMedium risk5.4K
Editors’ pick

Laravel's official MCP server, guidelines and skills: the agent sees the DB schema, logs and package versions and searches ecosystem docs

MCP serverMedium risk3.6K
Editors’ pick

The official FastAPI skill, bundled with the package, teaching agents to write code for the installed version

SkillLow risk

Firebase MCP Server

Firebase CLI and MCP Server

Editors’ pick

Official Firebase MCP server from the Firebase CLI: projects, Firestore, Auth, Crashlytics, Remote Config and function logs

MCP serverHigh risk