PlanetScale CLI
The pscale CLI for PlanetScale MySQL and PostgreSQL databases: branches, deploy requests, SQL and diagnostics, with an agent guide
Install
brew install planetscale/tap/pscalemacOS. 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 indexLimitations
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.
Related
Official skills and agents from the .NET team: performance, MSBuild, NuGet, upgrades, testing, ASP.NET Core, Blazor and MAUI
Laravel's official MCP server, guidelines and skills: the agent sees the DB schema, logs and package versions and searches ecosystem docs
The official FastAPI skill, bundled with the package, teaching agents to write code for the installed version
Firebase MCP Server
Firebase CLI and MCP Server
Official Firebase MCP server from the Firebase CLI: projects, Firestore, Auth, Crashlytics, Remote Config and function logs