PlanetScale through Squiid

MySQL built on Vitess with safe schema changes and branching. PlanetScale is on the Squiid roadmap.

Roadmap Provisioned Provisioned. Squiid creates the project or account for you and keeps the provider keys.

What PlanetScale is

PlanetScale is managed MySQL built on Vitess, the sharding layer that grew out of running MySQL at very large scale. Its signature workflow is schema changes as pull requests: you branch the database, apply the change on the branch, open a deploy request, and PlanetScale applies it to production without locking tables. Insights shows the slowest and most frequent queries, and sharding is available when one database stops being enough. Connections are pooled at the edge of the platform, so a serverless app that opens hundreds of short-lived connections does not exhaust the database.

For an AI-coded project the appeal is safety around migrations. Generated schema changes are the most common way an agent breaks production, and a workflow that reviews and applies them without downtime removes most of that risk. PlanetScale is also the natural choice when the code already assumes MySQL, for example an app that started on a PHP or Rails codebase, or a team with existing MySQL experience that does not want to relearn Postgres operational habits. Vitess also means the path from one database to many shards is a platform feature rather than a rewrite, which is a real consideration for anything that stores events or logs at volume.

Why connect it through Squiid

PlanetScale is on the Squiid roadmap. When it is connected, Squiid will provision the database, hold the connection credentials and expose the database and management API through https://api.squiid.io/v1/planetscale/... with Authorization: Bearer $SQUIID_API_KEY, with drivers working by base URL swap (gateway convention). Plan cost will pass through at the provider's listed price on your monthly Squiid invoice, usage will meter against prepaid credits, and connection strings will stop living in .env files where an agent can copy them into a log line.

  • One account, one key, one bill, one dashboard. PlanetScale sits beside every other service your project uses, on the same invoice and the same credit balance.
  • Key custody. Squiid holds the PlanetScale credentials. Your code carries SQUIID_API_KEY, so DATABASE_URL, PLANETSCALE_TOKEN, PLANETSCALE_ORG, PSCALE_DB never land in a repository, a preview deployment or an agent’s context.
  • Metering you can see. Every call is counted per service and per day, so you know what PlanetScale costs before the month ends.
  • Pause on zero. When prepaid credits run out the gateway stops authorizing usage instead of running up a bill you did not fund.
  • One rotation. Rotating the Squiid key cuts off every agent, worker and deployment at once, with no provider key to hunt down.

What you get

  • A provisioned MySQL database on Vitess
  • Branching and non-blocking deploy requests
  • Query insights without a separate tool
  • Provider pricing passed through on one invoice
  • Credentials held by Squiid, not your repo

How to connect PlanetScale

One variable replaces the provider credentials this service would normally need. Requests go to the gateway and the official SDKs work by pointing their base URL at it (gateway convention).

# .env
# replaces DATABASE_URL, PLANETSCALE_TOKEN, PLANETSCALE_ORG, PSCALE_DB
SQUIID_API_KEY=sq_live_xxxxxxxxxxxxxxxxxxxxxxxx

# every request: https://api.squiid.io/v1/planetscale/...
# header:       Authorization: Bearer $SQUIID_API_KEY
01

Add it in your dashboard

Open the Squiid catalog, add PlanetScale and fund credits. Squiid provisions the project and keeps the provider keys.

02

Put the one key in your env

Add SQUIID_API_KEY to .env and delete DATABASE_URL, PLANETSCALE_TOKEN, PLANETSCALE_ORG, PSCALE_DB. Nothing else from PlanetScale needs to exist in your project.

03

Point your agent at it

Claude Code, Cursor and Codex read the same variable and call https://api.squiid.io/v1/planetscale/. Agents open a deploy request for every schema change rather than running ALTER statements against production directly.

Pricing through Squiid

PlanetScale charges a monthly plan fee based on cluster size plus storage and additional usage, at the provider's listed price. Squiid passes that through at par: one dollar of prepaid credit is one dollar of PlanetScale usage, with no markup and no per-request margin.

PlanetScale has no subscription attached on Squiid today. If a plan is required for a feature you need, it passes through at the provider’s listed price with no Squiid fee.

Squiid adds no markup to provider prices. There is a free plan at $0 a month with a 15% fee when you top up credits, Solo at $19.97 a month with a top-up fee that starts at 8% and falls to 3.5% as your spend grows, Team from $29.97 a seat a month with the same ladder one point lower, and Custom with a rate of 3% or less. Credits are prepaid, so PlanetScale usage stops when the balance reaches zero rather than producing an invoice you did not fund. Auto top-up with a cap keeps production running without handing anyone an open-ended card.

If you leave

Export: dump the database and restore it into a project in your own PlanetScale account; PlanetScale has no project transfer we are confident of. Squiid never owns your code, your schema or your domain, and the gateway speaks PlanetScale's own API, so the client change is a base URL. The handover page lists what happens for every provider in the catalogue.

Works with every coding agent

PlanetScale through Squiid is just an HTTP call with a bearer token, so every agentic coding tool can use it with the single key already in your environment:

Vibe coding a feature on PlanetScale usually means asking for it in plain language and letting the agent write the integration. Because the key is Squiid’s rather than the provider’s, it can do that without ever holding a credential that could be leaked, logged or committed.

Related services

Questions people ask

Is PlanetScale available on Squiid yet?

Not yet. It is on the roadmap and will be a provisioned service when it lands, with Squiid holding the credentials.

Will schema deploy requests still work?

Yes. The branching and deploy request workflow is PlanetScale's own and will be reachable through the gateway's management path.

MySQL or Postgres for an agent-built app?

Most AI-generated code assumes Postgres by default. Choose PlanetScale when your codebase, ORM or team already leans MySQL.

How will PlanetScale be billed?

Plan cost passes through at the provider's listed price on the Squiid invoice, with any metered usage drawn from prepaid credits and no markup.

Can I migrate later without lock-in?

It is MySQL. Standard dump and restore tooling works, and Squiid does not hold your data hostage in any way.

Connect PlanetScale with one key.

PlanetScale runs MySQL on Vitess with database branching, non-blocking schema change requests and horizontal sharding. Planned for Squiid with provisioning and one bill.