planetscale — Claude Code plugin: MCP server and database skills
Adds the PlanetScale MCP server and database skills to Claude, so the agent can reach your organizations, branches, schema and Insights data.
/plugin install planetscale@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialWhat planetscale does
The plugin brings three pieces into Claude: the PlanetScale MCP server, Database Skills, and PlanetScale skills. With the MCP server connected, the agent can query your data, list organizations, databases and branches, read the schema, and pull up slow queries from Insights.
Skills ship vendored inside the repository, so a plugin install works from a plain checkout — no git submodule update --init needed. Upstream repos stay the source of truth, and pinned SHAs live in .skills-versions.json. To refresh them by hand, run bash scripts/sync-skills.sh and commit the result; a GitHub Actions workflow does the same weekly and opens a PR.
You need a PlanetScale account, since the MCP server is authenticated. After installing, run /mcp to confirm the planetscale server is listed. If it is missing, restart Claude fully — MCP server changes from a plugin take effect on restart.
What it helps with
- inspect database branches and schema without leaving the editor
- run a query against your data from Claude
- surface slow queries through Insights
- pull organization and account details
- sync the latest database skills from upstream
Example prompts for the agent
- Show the branches and schema in the
maindatabase - Find slow queries from the past week
- Query the
orderstable and show the first rows
How to install planetscale
Plugin marketplace
/plugin install planetscale@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about planetscale
How do I install planetscale in Claude Code?
Add the marketplace with /plugin marketplace add anthropics/claude-plugins-official, then install the plugin with /plugin install planetscale@claude-plugins-official.
What does the planetscale plugin do?
It installs the PlanetScale MCP server plus Database Skills and PlanetScale skills, giving the agent access to organizations, databases, branches, schema and Insights data.
What do I need for the MCP server to work?
A PlanetScale account, because the server is authenticated. Check /mcp after install; if the server is absent, restart Claude.
Source text
SKILL.md · Apache-2.0
# PlanetScale Claude Plugin Plugin for installing the [PlanetScale MCP server](https://planetscale.com/docs/connect/mcp), [Database Skills](https://db-skills.com/), and PlanetScale skills into Claude Code. ## Prerequisites - Claude Code with plugin support - A PlanetScale account for authenticated MCP features ## Install from GitHub In Claude Code, add this GitHub repository as a marketplace, then install the plugin: ```text /plugin marketplace add planetscale/claude-plugin /plugin install planetscale@planetscale ``` ### Verify it loaded In Claude Code, run `/mcp` to see the `planetscale` MCP server. If it does not appear immediately after install, fully restart Claude Code and check `/mcp` again. Plugin-provided MCP server changes are applied on restart. ## Skills Source and Sync Skills are **vendored** into this repository so Claude plugin installs work on a plain checkout (no `git submodule update --init`). Upstream remains the source of truth: - [`planetscale/database-skills`](https://github.com/planetscale/database-skills) → `database-skills/skills` (plus LICENSE/README) - [`planetscale/skills`](https://github.com/planetscale/skills) → `planetscale-skills` Pinned upstream SHAs are recorded in [`.skills-versions.json`](.skills-versions.json). ### Manual one-off update To pull the latest upstream skills into this repository: ```bash bash scripts/sync-skills.sh ``` Commit the resulting content and `.skills-versions.json` changes. ### Local testing To test this plugin from your local working copy (before branching/PR): ```bash claude --plugin-dir . ``` 1. Run `/mcp` to verify the `planetscale` MCP server is loaded (will require authentication). 2. Run `/skills` to verify the database and PlanetScale skills are loaded. ### Automated weekly updates GitHub Actions runs `.github/workflows/update-skills.yml` weekly and also supports manual runs (`workflow_dispatch`). When upstream `main` has new commits, the workflow opens or updates a PR that contains: - Updated vendored files under `database-skills/` and/or `planetscale-skills/` - Updated `.skills-versions.json` ### Alternative (development only) You can also use this direct local plugin load command: ```bash claude --plugin-dir . ``` ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and pull request guidance. ## License This project is licensed under the [Apache License 2.0](LICENSE).
© planetscale · Apache-2.0 · planetscale/claude-plugin
