No free plan is listed; the smallest Postgres cluster is $5/month single node or $15/month highly available, before storage, backup and egress extras. [3]
Guides · database · Everyday developer services
PlanetScale database (Postgres or Vitess)
Create a PlanetScale organization and database in a chosen region and cluster size, create a role and password, and optionally a service token for the API.
Researched · not yet run liveLast researched 25 October 2026 · PlanetScale · provider site
Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.
Who owns what
A PlanetScale user creates or joins an organization; databases (with branches) belong to the organization, which is billed.
- PlanetScale user personal owned by the person
- Organization billing · under PlanetScale user
Have ready
- A card for the organization. · The pricing page lists only paid cluster sizes (from $5/month); no free plan is listed. [3]Needed for: Create the database
Steps
Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.
Create an account and organization
The person signs up at PlanetScale and is prompted to create an organization. verapli never creates the account.
Where: https://app.planetscale.com/
Create the database
Choose New database, pick Postgres (or Vitess), name it, choose the primary region close to the app, pick cluster size and CPU architecture, and create it.
Where: https://app.planetscale.com/new
Create a role and copy the connection string
Open the database, click Connect, create the default role (or run pscale role reset-default <db> <branch>), and copy host, username and password, or a framework connection string. The password is shown once; verapli captures the connection string into DATABASE_URL.
verapli captures
DATABASE_URLhere by plain code: encrypted in your browser, never shown to AI.If something goes wrong (1)
- Password lost after leaving the page.: Reset the role password and update DATABASE_URL; passwords cannot be shown again. [1]
Where: https://app.planetscale.com/
Create a service token (optional)optional
In organization Settings, Service tokens, New service token, name it, then grant only the database permissions needed. Copy the token ID and the token.
Terms and gotchas
Plain-English summary, not legal advice. Each card links its source.
What you end up with
| Env var | Secret | Format | What it is |
|---|---|---|---|
DATABASE_URL | secret | postgresql://postgres.<branch-id>:<password>@<host>.horizon.psdb.cloud:5432/postgres?sslmode=verify-full | Postgres connection string including the role password. PlanetScale docs do not fix an env var name; DATABASE_URL is the common convention chosen by verapli. |
PLANETSCALE_SERVICE_TOKEN_ID | not secret | Service token ID (first half of the API Authorization header). Name chosen by verapli. | |
PLANETSCALE_SERVICE_TOKEN | secret | Service token secret (second half of the API Authorization header). Name chosen by verapli. |
Pricing
- Costs: Postgres PS-5 from $5/month (single node) or $15/month (HA); Vitess PS-10 from $39/month; extras for storage, backups, egress, replicas.
Source [3]
For agents
The same entry as JSON: /api/v1/entries/planetscale/database · requirements /api/v1/requirements/planetscale/database · terms /api/v1/terms/planetscale/database.
Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp
> "What do I need for PlanetScale database (Postgres or Vitess), and how long will it take?"
→ tools/call requirements { "provider_id": "planetscale/database" }Sources
- PlanetScale Postgres quickstart Sign up then create an organization; New database (/new), Postgres engine, name, primary region (CLI default us-east), cluster size and CPU architecture; main branch by default; Connect, Create default role or pscale role reset-default; passwords shown only once; connection string format with port 5432 (6432 PgBouncer). · accessed 25 October 2026 · official
- Service tokens Organization Settings, Service tokens, New service token; service token ID and token values; API Authorization header <SERVICE_TOKEN_ID>:<SERVICE_TOKEN>. · accessed 25 October 2026 · official
- PlanetScale pricing Cheapest Postgres single node PS-5 $5/month, HA PS-5 $15/month, Vitess PS-10 $39/month (AWS us-east-1); no free plan listed. · accessed 25 October 2026 · official
- Stripe Projects provider catalogue PlanetScale is listed in the Stripe Projects catalogue as planetscale/postgresql (Database). · accessed 25 October 2026 · official
Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. PlanetScale is not affiliated with verapli.