Skip to content
Agentmart
Submit a tool

PlanetScale

Connect to PlanetScale databases, branches, schema, query insights, and execute SQL

Connector by planetscaleOfficial · GitHub account verified by the MCP Registry

IndexedApache-2.0Remote (HTTP)★ 5
Write a review

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/planetscale-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://mcp.pscale.dev/mcp/planetscale Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Connect to PlanetScale databases, branches, schema, query insights, and execute SQL

Use cases: database-access, monitoring-observability

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
12 read · 0 write · 2 delete
Secrets
None asked for
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 14

Read from the source code; the running server may list different tools.

Read 12 · Look things up without changing anything.

  • execute_read_query
  • get_branch_metrics
  • get_insights
  • get_payment_method_setup
  • get_postgres_logs
  • get_query_tag
  • list_cluster_sizes
  • list_query_error_executions
  • list_query_error_patterns
  • list_query_tag_summaries
  • list_query_tags
  • search_documentation

Delete 2 · Delete, drop, revoke or wipe things.

  • execute_write_query
  • update_payment_method

Network hosts it talks to 1

  • mcp.pscale.dev · found in remote endpoint, install command

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • execute_read_queryRun a read-only SQL queryread-only

    Execute a read-only SQL query against a PlanetScale database. Write operations are rejected by the database role. This tool creates short-lived credentials and executes the query securely. Queries have a maximum execution time of 50 seconds — if a query exceeds this limit it will be cancelled, so ensure queries are optimized. For Postgres and Neki, this tool uses an ephemeral pg_read_all_data role that does not bypass row-level security (RLS); zero-row or zero-count results on RLS-protected tables may mean rows are hidden by policy, and the response may include warnings when that risk is detec…

  • execute_write_queryRun a write SQL querycan change or delete data

    Execute a write SQL query (INSERT, UPDATE, DELETE, or DDL) against a PlanetScale database. This tool creates short-lived credentials and executes the query securely. Queries have a maximum execution time of 50 seconds — if a query exceeds this limit it will be cancelled, so ensure queries are optimized. TRUNCATE is blocked. DELETE and UPDATE without WHERE clause are blocked. For Postgres and Neki only: use postgres_database_name when the user has created additional databases in the same cluster and wants to run the query against a non-default database. IMPORTANT: DELETE queries and DDL stateme…

  • get_branch_metricsGet branch metricsread-only

    Get infrastructure metrics for a PlanetScale branch: CPU, memory, disk, replication lag, connections, PgBouncer, WAL, VTGate, and tablet health. The database kind selects the endpoint. Vitess uses tablet metrics; Postgres and Neki use branch metrics. view summary (the default) returns latest, min, avg, p95, and max for a small health set plus current disk and connection values, without raw samples. Use p95 rather than max to judge typical load. Pod memory utilization includes page cache, so the summary also returns RSS and cache bytes. Vitess shard_storage_usage is percent full, not bytes. Use…

  • get_insightsGet query performance insightsread-only

    Description is built at runtime.

  • get_payment_method_setupGet billing card setup statusread-only

    Get a Stripe Checkout payment method setup started by update_payment_method. Use the setup_id returned by that tool; it is not a payment method ID. This is a one-time check and does not wait. If pending, give checkout_url to the customer and call this tool again only after they finish Checkout. If completed, this tool also returns the saved card brand, last four digits, expiration, and cardholder name as confirmation. Failed or expired setups cannot be resumed. Requires full access to the organization's payment method to inspect the setup and return the saved card.

  • get_postgres_logsGet Postgres server logsread-only

    Fetch server logs for a PlanetScale Postgres or Neki database branch (not available for Vitess/MySQL databases). Returns recent log entries sorted newest first. Supports filtering by log level, time range, server role, and pod name, plus an optional raw LogsQL query for advanced filtering (e.g. word matching, field filters, and pipe stages like 'error | stats count()'). Default time window is the last hour.

  • get_query_tagGet query tag detailsread-only

    Description is built at runtime.

  • list_cluster_sizesList cluster sizesread-only

    List available PlanetScale cluster sizes (SKUs) for an organization and database engine, including Neki-specific PS-*_NEKI sizes. 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.

  • list_query_error_executionsList failed query executionsread-only

    Description is built at runtime.

  • list_query_error_patternsList query error patternsread-only

    Description is built at runtime.

  • list_query_tag_summariesSummarize query tag performanceread-only

    Description is built at runtime.

  • list_query_tagsList query tagsread-only

    Description is built at runtime.

  • search_documentationSearch PlanetScale documentationread-only

    Search across PlanetScale documentation and blog posts 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 documentation pages and /blog posts.

  • update_payment_methodStart billing card setupcan change or delete data

    Start a secure Stripe Checkout session to add or replace an organization's billing card. Use when a customer asks to add, set, replace, or update their PlanetScale payment method. This tool never collects card details: return checkout_url to the customer and let them complete Stripe Checkout in their browser. It returns a setup_id; do not call this tool again while that setup is pending. After the customer finishes, call get_payment_method_setup with the same organization and setup_id. Requires full access to the organization's payment method.

Compare and alternatives

    Featured in

    Signals

    Stars
    5
    Forks
    5
    Open issues
    0
    Last commit
    Oct 11, 2026 (17 days ago)
    Last release
    Apr 15, 2026 (6 months ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.planetscale/mcp-server
    Version
    1.0.0
    Auth
    Auth not stated
    License
    Apache-2.0
    Repository
    github.com/planetscale/mcp-server
    Website
    planetscale.com/docs/connect/mcp
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from planetscale

    Cite this page

    PlanetScale MCP server. Agent Mart. https://agentmart.dev/connectors/planetscale-mcp-server (last updated 2026-10-24)