PlanetScale

Manage databases, branches, and organizations while monitoring query performance insights.

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Planetscale List Regions For Organization: List the regions available for an organization.
  • Planetscale Get Invoice Line Items: Get all line items for an invoice. See prorated costs broken down by database branch. Including storage, egress bandwidth and development branches.
  • Planetscale List Invoices: List all invoices for an organization.

What data it sees

Do you need an account

No: the server works without sign-in

Manage databases, branches, and organizations while monitoring query performance insights. Execute read and write SQL queries securely to interact with your data in real-time. Search documentation and access billing details to streamline your administrative workflow.

How to connect

How to connect PlanetScale to Claude

The server address to paste into Claude settings:

https://planetscale.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect PlanetScale to ChatGPT

The server address to paste into ChatGPT settings:

https://planetscale.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect PlanetScale to Cursor

The server address to paste into Cursor settings:

https://planetscale.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (16)

Raw names from tools/list. Only developers need these.

planetscale_list_regions_for_organizationList the regions available for an organization.
planetscale_get_invoice_line_itemsGet all line items for an invoice. See prorated costs broken down by database branch. Including storage, egress bandwidth and development branches.
planetscale_list_invoicesList all invoices for an organization.
planetscale_list_schema_recommendationsList all schema recommendations for a database. Each schema recommendation is based on production data from the users database. If you have access to the code base generating the queries, evaluate the code in the context of the recommendation to determine the best steps forward for the specific application. Use schema recommendations as a data point for improvement, not a directive. Suggestions include adding indexes, removing redundant indexes, preventing primary key exhaustion, unused tables and other general performance improvements. See https://planetscale.com/docs/postgres/monitoring/schema-recommendations for a full list as well as warnings of possible risks when making schema changes. Set `state` to "open" to retrieve only open recommendations.
planetscale_get_branch_schemaGet the schema (tables, columns) for a database branch
planetscale_list_branchesList all branches within a databases
planetscale_get_organizationGet details about a specific organization
planetscale_list_databasesList all databases within an organization
planetscale_get_branchGet details about a database branch
planetscale_get_databaseGet details about a specific database
planetscale_list_organizationsList all PlanetScale organizations you have access to
planetscale_search_documentationSearch across the PlanetScale knowledge base to find relevant information, code examples, API references, and guides. Use this tool when you need to answer questions about PlanetScale, find specific documentation, understand how features work, or locate implementation details. The search returns contextual content with titles and direct links to the documentation pages.
planetscale_list_cluster_sizesList available PlanetScale cluster sizes (SKUs) for an organization. PS-* sizes use autoscaling network-backed storage; M-* sizes use super fast NVMe storage drives. The rate field is for an HA cluster with 2 replicas; replica_rate is for a single instance. Single instance databases are only available for Postgres. Metal instances must be HA.
planetscale_get_insightsGet query performance insights for a PlanetScale database branch. By default, aggregates the top queries across 5 different metrics (slowest, most time-consuming, most rows read, most inefficient, most rows affected) for a comprehensive view. Can also fetch queries sorted by a single metric.
planetscale_execute_write_queryExecute a write SQL query (INSERT, UPDATE, DELETE, or DDL) against a PlanetScale database. This tool creates short-lived credentials and executes the query securely. TRUNCATE is blocked. DELETE and UPDATE without WHERE clause are blocked. IMPORTANT: DELETE queries and DDL statements (CREATE, DROP, ALTER, RENAME) require human confirmation - you MUST ask the user for explicit approval before setting confirm_destructive: true. Never set confirm_destructive without first showing the user the exact query and getting their explicit 'yes' or approval.
planetscale_execute_read_queryExecute a read-only SQL query (SELECT, SHOW, DESCRIBE, EXPLAIN) against a PlanetScale database. This tool creates short-lived credentials and executes the query securely.