PlanetScale MCP server
Commit Nov 13, 2026Connect to PlanetScale databases to manage branches, schemas, query insights, and execute SQL commands.
Also known as planetscale/mcp-server, mcp-server
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 13, 2026
- License
- Apache-2.0
What is PlanetScale MCP?
PlanetScale connects to PlanetScale databases to manage branches, schemas, query insights, and execute SQL commands.
Summary generated from the project's README
About PlanetScale MCP server
Managing PlanetScale databases directly from an AI client allows developers to handle database operations without switching between different interfaces. This server provides tools to manage branches, modify schemas, view query insights, and execute SQL commands. It is designed for developers who want to integrate their database management workflow into their existing AI-driven development environment.
The implementation includes specific tools maintained in TypeScript alongside additional functionality generated from the PlanetScale API OpenAPI specification. Users can run the server locally via stdio for development and testing using the MCP Inspector. While some tools are manually maintained, the full hosted version provides a broader range of capabilities derived from the official API spec to ensure comprehensive database control.
Written from the project's README. Every use case is checked against a quote from it.
How to install PlanetScale MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall PlanetScale MCP in Claude Code
$ claude mcp add --transport http mcp-server https://mcp.pscale.dev/mcp/planetscaleInstall PlanetScale MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.pscale.dev/mcp/planetscale"
}
}
}Install PlanetScale MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.pscale.dev/mcp/planetscale"
}
}
}Install PlanetScale MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.pscale.dev/mcp/planetscale"}'Install PlanetScale MCP in Codex
$ codex mcp add mcp-server --url https://mcp.pscale.dev/mcp/planetscaleInstall PlanetScale MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] url = "https://mcp.pscale.dev/mcp/planetscale"
Install PlanetScale MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp-server https://mcp.pscale.dev/mcp/planetscaleInstall PlanetScale MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.pscale.dev/mcp/planetscale",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableplanetscale/mcp-server is public and reachablegithub.com/planetscale/mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/planetscale/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubPlanetScale MCP Server Tools
This repository contains tool implementations that are part of the PlanetScale MCP server.
The full hosted MCP server includes additional tools that are generated from the PlanetScale API OpenAPI spec, not every production tool lives in this repository.
Related docs
- Hosted server overview: PlanetScale MCP docs
- PlanetScale API OpenAPI spec: OpenAPI spec docs
Project scope
This repo is focused on:
- MCP tools we maintain directly in TypeScript
- shared helper code used by those tools
- local development and validation of the open-source portions
Some MCP functionality is intentionally not duplicated here because it is generated from the API spec and maintained in that generation pipeline.
Quick start
Install dependencies:
pnpm install
Build a deployment zip:
pnpm build
Push to Gram:
pnpm push
Testing locally
Run a local MCP server over stdio with inspector support:
pnpm dev
This launches MCP Inspector so you can interactively test tool behavior during development.
Contributing
See CONTRIBUTING.md for contribution workflow and project conventions.
PlanetScale MCP questions
How do I add PlanetScale MCP to Claude Code?
Run claude mcp add --transport http mcp-server https://mcp.pscale.dev/mcp/planetscale in your terminal. Add --scope user to make it available in every project.
How do I add PlanetScale MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this repository contain all available PlanetScale MCP tools?
No, this repository only contains tools maintained directly in TypeScript; other tools are generated from the PlanetScale API OpenAPI spec.