Database · Integration · New in 0.3.0

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

About 3 minBilled

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 PlanetScale's key page ↗

  1. Open Settings → Service tokens → New service token.
  2. Name it Burnstack and click Create service token.
  3. Copy the service token ID and the token.
  4. On the token's page tick read_invoices (and read_organization), then Save permissions.
  5. 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.
Burnstack Connectors, Add cost source tab: a search box, category filters and one card per vendor with its key steps

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?
PlanetScale's invoices are monthly and their lines have no dates, so Burnstack spreads each line evenly over its billing period, the same way an imported monthly invoice line is spread. The month's total is exact.
Can the token change my databases?
No. With only 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.