Credits pay for agents — the parts of MentionBird that do extra work on demand, like analysing why you're not ranking for a prompt or summarising a cited video.
Routine prompt checking doesn't use credits. That's covered by your plan's prompt capacity, which is a separate thing. See How limits work.
You always see the cost first
Before an agent runs, MentionBird shows what it will cost and asks you to confirm. Nothing is charged from a click you didn't expect.
Some agents cost a flat amount; others scale with the size of the job, so analysing a long video costs more than a short one. The confirmation step shows the real cost for that specific run, which makes it the authoritative answer rather than anything written here.
Failed runs are refunded
Credits are reserved when a run starts and refunded automatically if it fails — a page that can't be fetched, a video that can't be processed, an error on our side.
Some failures never charge you at all, because they're caught before any work begins: a video that's private or too long, or not having enough credits in the first place. In those cases nothing is reserved and there's nothing to refund.
You pay for results rather than attempts. If you ever see a charge for a run that clearly failed, get in touch and we'll sort it out.
Monthly credits and purchased credits
Your plan grants credits at the start of each billing period. Unused monthly credits expire at the end of that period — they don't roll over.
Credits you buy separately as a top-up never expire.
When working out what to expire at the end of a period, MentionBird assumes your monthly credits were used first. The effect is the one you'd want: purchased credits are always what's left over, and buying a top-up never means losing it to an expiry date.
Your balance is a single number covering both, so there's nothing to manage. The practical implication is worth planning around though — monthly credits sitting unused near the end of a period are about to disappear, so that's the moment to run the analysis you've been putting off.
Checking your balance and history
Your balance is on the billing page, with a history of everything that affected it — grants, spends, refunds, and expiries, each as its own line with the running balance.
If a number looks wrong, that history is the place to start. Refunds appear as their own entries rather than reversing the original, so a failed run shows as a charge followed by a refund.
Running out
If a run would cost more than you have, MentionBird tells you before starting rather than doing part of the work. Nothing is charged.
From there you can buy more credits, or wait for your next monthly grant. Your prompt tracking continues either way — running low on credits pauses agents, not the routine checking your plan covers.
