PlanetScale cost tracking: invoice amounts per database
See what each PlanetScale database costs, from the amounts on your invoices, next to the rest of your stack.
What Burnstack tracks
- Billed amounts per database and line item from PlanetScale's invoices (PlanetScale API)
- Each line spread evenly over its billing period, so a month's charges show as a daily average
- Taxes, credits and rounding as an adjustment on the organization, so each invoice adds up to its total
Alerts
- Spike alerts can't see PlanetScale: amounts are monthly and spread evenly, so a spike shows up as a higher daily average once the invoice exists.
The key you'll need
A service token with only the read_invoices organization permission, created at app.planetscale.com → Settings → Service tokens (PlanetScale docs). Paste its ID and the token joined by a colon: TOKEN_ID:TOKEN. If the token can see several organizations, put the organization's name in front: org:TOKEN_ID:TOKEN.
Burnstack checks the key with PlanetScale, shows the account it belongs to when PlanetScale lets the key see it, and stores it in your computer's keychain (macOS Keychain or Windows Credential Manager). It only reads billing and usage.
Connect it: PlanetScale
Need
- Key: Service token
- Plan: Any plan.
- Permissions: read_invoices read_organization (optional, shows the plan)
Under your organization's Settings → Service tokens, create a token and give it only the read_invoices organization permission (add read_organization to show the plan). Paste the ID and token joined by a colon: SERVICE_TOKEN_ID:SERVICE_TOKEN. Invoices are monthly, so each month's charges are spread evenly over its days.
Steps
- Open Settings → Service tokens → New service token.
- Name it Burnstack and click Create service token.
- Copy the service token ID and the token.
- On the token's page tick read_invoices (and read_organization), then Save permissions.
- Paste SERVICE_TOKEN_ID:SERVICE_TOKEN into Burnstack.
Paste it
In Burnstack: Connectors → PlanetScale → Add key → paste → Validate & save. The key goes straight into your computer's keychain.
If it fails
- needs the read_invoices organization permission
- Open the token under Settings → Service tokens, tick read_invoices and Save permissions.
- Check the service token ID and token
- Paste SERVICE_TOKEN_ID:SERVICE_TOKEN exactly as shown when the token was created.
- This token can see several organizations
- Put the organization in front: organization:SERVICE_TOKEN_ID:SERVICE_TOKEN.
Let your AI do the clicking
Paste this into an AI assistant that can use your browser, such as Claude in Chrome. It opens PlanetScale's key page and sets only the permissions above, then stops before the final button that creates the key.
Open https://app.planetscale.com/~/settings/service-tokens in my browser. Choose 'New service token' and name it 'Burnstack'. PlanetScale has no expiry setting for this token, so skip that. Stop before clicking 'Create service token' (the final button that creates the token) and tell me it's ready. I'll click it, copy the token and paste it into Burnstack myself. Don't copy, read or paste the token, and don't grant broader access or change any other setting. After I say I've copied the ID and token, open the token's page from Settings → Service tokens, tick only read_invoices and read_organization, and click 'Save permissions'. If PlanetScale asks me to sign in or confirm with 2FA, wait for me.
The key never passes through the AI: you click that last button yourself, copy the key and paste it into Burnstack.
What you'll see
- Billed: Billed cost, as PlanetScale charges it.
- History: All invoices since the organization started.
- Delay: Monthly: charges appear with the invoice and are spread over its days.
Good to know
- Monthly amounts only: invoice lines have no dates, so the days are an even spread, not daily usage.
- PlanetScale's docs don't say whether the current month's invoice is listed before it closes. If it isn't, a month appears once it ends.
- Invoices are taken as USD.
One bill, not a dashboard per vendor
Burnstack puts PlanetScale next to the rest of your spend and lets you group it by product with applications. Other integrations: Vercel, Neon, Supabase, OpenAI, Anthropic, GitHub, OpenRouter, DigitalOcean, Twilio, Stripe fees, Cloudflare, Netlify, AWS, Datadog, Sentry, Cursor, Azure, Google Cloud, MongoDB Atlas, Railway, Render, Heroku, Akamai (Linode), Vultr, Fastly, Runpod, xAI, Together AI, fal.ai, Runway, Upstash.
PlanetScale questions
Why is every day of the month the same PlanetScale cost?
Can the token change my databases?
read_invoices it can list invoices and their line items, nothing else.Start watching back.
Five minutes to connect your first vendor. Free for Mac, forever, and every byte stays yours.