Before you start
Access to your Polar organization’s developer settings.
Set it up
- Open your organization → Settings → Developers → New Organization Access Token, and name it
Sprid. - Select metrics:read only.
- Create the token. It is shown once.
- Copy the token and leave it on your clipboard.
Connect to Sprid
sprid connect polar --app <slug> --key-from-clipboardUse your Sprid app slug. A personal token covering several organizations also needs --org <organization-id>.
Sprid reads the token 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 token is copied and it runs this for you. Typing it yourself, copy the token last: paste the command into your terminal first, then copy the token, then press Enter. If the clipboard still holds the command, Sprid refuses it; copy the token and run it again. Without clipboard access (a remote shell), save the token to a file and pass --key <file> instead.
Check the connection
Ask your agent: “Check that Sprid can read revenue and subscriptions for this Polar organization.” A saved token alone does not confirm access.
What the numbers mean
Polar’s daily revenue and current monthly recurring revenue. Polar supplies no trial count, so that field stays blank.
If something goes wrong
- Access denied: create a replacement token with metrics:read, then reconnect.
- Wrong or empty results with a personal token: add
--org <organization-id>.
Investigate with this connection
Reads metrics, orders and subscriptions for the pinned organization. Product filters separate apps sold through the same organization.
sprid marketing-review capabilities --app <slug> --source polar --jsonSee connected queries.
Sources and verification
Prefer your terminal? sprid docs polar reads this same guide.