Before you start
Permission to create a restricted API key in Stripe: live and read-only, beginning with rk_live_.
Set it up
- Open Stripe → Developers → API keys → Restricted keys → Create restricted key, and name it
Sprid. - Set these to Read:
- Core → Charges and Account
- Billing → Subscriptions, Invoices and Prices
- Leave every other permission at None.
- Create the key.
- Copy the key and leave it on your clipboard.
Connect to Sprid
sprid connect stripe --app <slug> --key-from-clipboardUse your Sprid app slug. Keep the key out of chat.
Sprid reads the key from your clipboard, saves it and clears the clipboard, so it never shows on screen or lands in a file. Working with an agent? Tell it the key is copied and it runs this for you. Typing it yourself, copy the key last: paste the command into your terminal first, then copy the key, then press Enter. If the clipboard still holds the command, Sprid refuses it; copy the key and run it again. Without clipboard access (a remote shell), save the key to a file and pass --key <file> instead.
Check the connection
Ask your agent: “Read this app’s Stripe revenue through Sprid and check that it is the right account.” A saved key alone does not confirm access.
What the numbers mean
MRR is current active and past-due subscription prices, with annual plans spread over 12 months. It excludes trials and ignores discounts, proration and tax, so it differs from Stripe’s dashboard. Revenue covers 28 complete calendar days; refunds restate the original charge date. Currencies stay separate.
If you also use RevenueCat
If RevenueCat may already count these Stripe sales, Sprid withholds the combined total until the overlap is resolved and currencies and definitions match.
If something goes wrong
- Key rejected: check the copied value is complete and starts with
rk_live_. - Permission denied: check every Read permission above, then reconnect with a corrected key.
- MRR is zero but sales appear: one-off purchases count as revenue, not recurring subscriptions.
Investigate with this connection
Reads subscriptions and charges for the key’s merchant account. Filter by price or customer when several products share it. Amounts keep currency and minor units; Stripe SQL and Analytics are not exposed.
sprid marketing-review capabilities --app <slug> --source stripe --jsonSee connected queries.
Sources and verification
Prefer your terminal? sprid docs stripe reads this same guide.