PlanetScale MCP Server for Claude

Content

PlanetScale MCP Server is PlanetScale's official hosted Model Context Protocol server for connecting Claude and other MCP-capable clients to PlanetScale organizations, databases, branches, schemas, Insights, documentation search, and selected account operations. It runs as a remote HTTP server at https://mcp.pscale.dev/mcp/planetscale and uses PlanetScale OAuth to grant the client configurable permissions.

Use it when Claude needs current database context while planning migrations, debugging query performance, inspecting branches, reviewing schema changes, or drafting database recommendations. Start with read-only or Insights-only access for analysis tasks, and enable write query access only for a specific approved workflow.

Features

• Official PlanetScale documentation page for MCP setup, client instructions, OAuth permissions, query handling, tools, and troubleshooting.
• Hosted remote HTTP MCP server at https://mcp.pscale.dev/mcp/planetscale.
• Insights-only hosted endpoint at https://mcp.pscale.dev/mcp/planetscale-insights-only.
• Claude connector listing and custom connector setup.
• Claude Code plugin setup through the PlanetScale Claude plugin marketplace.
• Direct Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, OpenCode, Amp, Notion, and other MCP client setup paths.
• OAuth-scoped access with no access, read-only access, or full access at the organization or per-database level.
• Short-lived ephemeral database credentials for query execution.
• Read query routing to a replica when a replica is configured.
• Query attribution with source=planetscale-mcp comments visible in Insights.
• Public TypeScript source repository for the direct tools and shared helpers.
• Additional hosted tools generated from PlanetScale's OpenAPI specification.

Tool Surface

PlanetScale documents tools for listing and inspecting organizations, databases, branches, branch schemas, regions, cluster size SKUs, invoices, invoice line items, Insights, documentation search, and schema recommendations. The hosted server can also expose SQL tools for read queries and write queries when the selected OAuth permissions allow them.

The open source repository contains direct TypeScript tool implementations and shared helpers. PlanetScale notes that the full hosted server also includes additional tools generated from its OpenAPI specification, so the hosted server can have a broader tool surface than the repository alone.

Installation

Claude Code

Install PlanetScale's Claude Code plugin:

/plugin marketplace add planetscale/claude-plugin
/plugin install planetscale@planetscale

Or add the hosted server directly:

claude mcp add --transport http "planetscale" https://mcp.pscale.dev/mcp/planetscale

After connecting, authorize PlanetScale in the browser and choose the narrowest OAuth permissions that match the task.

Manual MCP Config

Use this remote HTTP configuration for clients that accept MCP JSON configuration:

{
  "mcpServers": {
    "planetscale": {
      "transport": "http",
      "url": "https://mcp.pscale.dev/mcp/planetscale"
    }
  }
}

For an analysis-only workflow that should not expose SQL query execution tools, use the Insights-only server URL:

https://mcp.pscale.dev/mcp/planetscale-insights-only

For Codex CLI, PlanetScale documents:

codex mcp add planetscale --url https://mcp.pscale.dev/mcp/planetscale

Use Cases

• Ask Claude to inspect the schema for a branch before drafting migration notes.
• Review query Insights and schema recommendations while investigating slow queries.
• Compare branches before summarizing a deploy request or database change plan.
• Search PlanetScale documentation from the same MCP client while designing a database workflow.
• List available regions or cluster size SKUs before writing an infrastructure change proposal.
• Use the Insights-only endpoint to summarize query performance without giving Claude SQL execution tools.
• Run a narrow read query after confirming the organization, database, branch, table, filters, and row limit.
• Draft a write query for manual review before executing it through an approved deployment or database-change process.

Safety Checklist

• Start with no database access, read-only access, or the Insights-only endpoint whenever possible.
• Record the intended organization, database, and branch in the project prompt or AGENTS.md before connecting.
• Keep MCP client approval prompts enabled for query execution and any account-level operation.
• Review every generated SQL statement before approving it.
• Avoid write query access for production databases unless an owner has approved the exact task.
• Add row limits, time windows, and branch filters to exploratory queries.
• Check Insights for source=planetscale-mcp when auditing MCP activity.
• Revoke or reduce OAuth authorization when the temporary workflow is complete.

Source Links

• PlanetScale MCP docs: https://planetscale.com/docs/connect/mcp
• Source repository: https://github.com/planetscale/mcp-server
• PlanetScale OpenAPI specification docs: https://planetscale.com/docs/api/openapi-spec
• MCP specification: https://modelcontextprotocol.io/specification/2025-06-18/