---
name: stripe-revenue-snapshot
description: Report revenue, balance, payouts, new and churned subscriptions and failed-payment rate from Stripe for a period, compared with the previous period. Use when the user asks how much they made, for MRR, churn, a weekly or monthly revenue summary, or their Stripe balance.
---

# Stripe revenue snapshot

Read-only.

## Steps

1. Confirm the account, mode, period and currency. Default to the last full month compared with the month before.
2. Balance and payouts: `get_balance_summary` for available and pending balance; list payouts with `stripe_api_read` for the period.
3. Revenue and subscriptions: ask `stripe_analytics` for gross volume, net volume after refunds and fees, MRR, new subscriptions, cancellations and failed payments. Fall back to `stripe_api_read` on charges, invoices and subscriptions only when analytics cannot answer, and say so.
4. Compare with the previous period and call out any change over 10%.
5. Explain the drivers when you can see them: a large refund, a price change, a failed-payment spike or a big new customer.

## Report

- Headline: net revenue and change; MRR and change.
- New vs churned subscriptions; failed-payment rate.
- Balance available, pending, and the next payout.
- Caveats: currencies converted, refunds outside the period, test mode.

Do not present this as accounting or tax figures; it is Stripe's view of payments.
