PlanetScale MCP server for AI apps

What your AI apps can do with PlanetScale

List databases and branches
Run read-only queries and review insights

PlanetScale MCP tools

26 tools, taken from the publisher's documentation on 29 October 2026. The server decides what it offers and can add or rename tools at any time; after you connect, Toolstile shows the current list.

Tool	What it does
`planetscale_list_organizations`	List the organizations you can access
`planetscale_list_databases`	List the databases in an organization
`planetscale_list_branches`	List the branches of a database
`planetscale_get_organization`	Get details for an organization
`planetscale_get_database`	Get details for a database
`planetscale_get_branch`	Get details for a branch
`planetscale_get_branch_schema`	Get a branch's schema
`planetscale_execute_read_query`	Run a read-only SQL query (SELECT, SHOW, DESCRIBE, EXPLAIN)
`planetscale_execute_write_query`	Run a write SQL query (INSERT, UPDATE, DELETE or DDL)
`planetscale_get_insights`	Get query performance insights for a branch
`planetscale_list_regions_for_organization`	List the regions available to an organization
`planetscale_list_cluster_size_skus`	List the available cluster size SKUs
`planetscale_list_invoices`	List an organization's invoices
`planetscale_get_invoice_line_items`	Get invoice line items with prorated costs per branch
`planetscale_get_organization_billing_payment_method`	Show the organization's current payment method
`planetscale_update_payment_method`	Start Stripe Checkout to update the payment method
`planetscale_get_payment_method_setup`	Check the status of a payment method setup
`planetscale_search_documentation`	Search the PlanetScale documentation
`planetscale_list_schema_recommendations`	List schema recommendations such as adding or removing indexes
`planetscale_list_query_error_patterns`	List failing queries grouped by error fingerprint
`planetscale_list_query_error_executions`	List individual failed executions for an error fingerprint
`planetscale_get_postgres_logs`	Get Postgres server logs, newest first, with filters
`planetscale_list_query_tags`	List query tags with their values and counts
`planetscale_get_query_tag`	Get a single query tag by ID
`planetscale_list_query_tag_summaries`	Summarize query statistics grouped by tag values
`planetscale_get_branch_metrics`	Get CPU, memory, disk, replication lag and connection metrics

Suggested access for each AI app

The documentation this list comes from doesn't mark PlanetScale's tools as read-only or destructive. Read each tool's description and decide per app before allowing it.

Coding agent in Claude Code or Cursor. Allow the read tools so the agent can look things up without stopping, and require approval for tools that change shared data.

Chat or research app in Claude Desktop. Allow reading and searching. Allow writes only where you want the app to act for you.

Unattended agent, such as a scheduled Codex job. No one is watching the session, so keep it narrow: allow what the job needs, require approval for changes and block the rest.

Blocked tools are removed from the tool list an app sees, so it won't try them. Because rules apply per app, the same PlanetScale connection can be broad in one app and read-only in another, and the credential stays in Toolstile instead of each app's config file.

How it works with Toolstile

Connect once. Add PlanetScale to a workspace (browser sign-in). Toolstile keeps the credential, so no agent config holds it.
Choose access per app. Give Claude Code every PlanetScale tool, give Cursor only the read tools, or keep PlanetScale away from an app entirely.
Share approved accounts. Teammates use the connection without copying tokens, and you can remove access in one place.
Review activity. See which app called which tool and when, so you can tighten access with evidence.

Add the PlanetScale MCP server to an AI app

Through Toolstile, every AI app uses one gateway entry, whichever servers you connect. In Claude Code:

Shell

claude mcp add --transport http toolstile 'https://mcp.toolstile.com/mcp'

Then connect PlanetScale in your workspace and choose which of its tools that app may use. Client setup covers Codex, Cursor and Claude Desktop.

To connect directly instead, add the PlanetScale endpoint to each app separately. In Claude Code:

Shell

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

In Cursor's mcp.json:

JSON

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

Some servers accept only clients they have approved, or need a token header. Check the PlanetScale MCP documentation for what your client needs.

Before you connect

A PlanetScale account. Sign-in uses your PlanetScale permissions.

Server details

Detail	Value
Publisher	PlanetScale
Endpoint	`https://mcp.pscale.dev/mcp/planetscale`
Authentication	Browser sign-in
Categories	Development, Data & infrastructure
Tool list	26 tools, observed 29 October 2026 (docs)

PlanetScale MCP documentation

PlanetScale MCP server for Claude, Codex and Cursor