Subscription Recovery Agent
Coordinates dunning, entitlement risk, and customer messaging when recurring payments fail.
The Subscription Recovery Agent supports recurring revenue operations by recommending the next best recovery action when payment collection fails.
It receives Subscription Payment Due Subscription Payment Due Event v0.0.1 Emitted when a subscription payment is due for collection Schema Map View docs , Payment Failed Payment Failed Event v0.0.1 Emitted when a payment attempt fails Schema Map View docs , and User subscription cancelled User subscription cancelled Event v0.0.1 An event that is triggered when a users subscription has been cancelled Owner subscriptions-management Map View docs so billing and support teams can keep the customer active when recovery is still likely.
Tools
| Name | Type | Description | URL |
|---|---|---|---|
| Dunning strategy planner | Selects retry cadence, grace period messaging, and escalation path from account value and failure reason. | mcp.example.com/.../dunning-strategy | |
| Entitlement risk lookup | Checks active entitlements, usage health, account age, and churn risk before recommending suspension. | mcp.example.com/.../entitlement-risk |
Responsibilities
- Recommend retry timing and grace-period actions for failed renewals.
- Explain entitlement impact before a subscription is suspended.
- Draft customer-facing payment recovery messages for the notification queue.
Collaborators
The agent works with Billing Service Billing Service Service v0.0.1 Manages billing cycles, invoice generation, and payment scheduling for subscriptions Publishes InvoiceGenerated , SubscriptionPaymentDue Subscribes PaymentProcessed APIs GraphQL Owner dboyne
Map
Repo
View docs , Subscription Service Subscription Service Service v0.0.1
Service that handles subscriptions
Publishes UserSubscriptionStarted , UserSubscriptionCancelled Subscribes PaymentProcessed Owner subscriptions-management
Map
Repo
View docs , Payment Gateway Service Payment Gateway Service Service v0.0.1
Manages integration with external payment processors (Stripe, PayPal, etc.) Publishes PaymentFailed , ChargeCard Subscribes ProcessPayment , FraudCheckCompleted +2 Owner dboyne
Map
Repo
View docs , and Notifications Notifications Service v0.0.2
Service that handles notifications across multiple channels (email, SMS, push)
Publishes NotificationSent Subscribes InventoryAdjusted , PaymentProcessed +5 Owner order-management
Map
Repo
View docs during the Subscription Payment Failure Flow Subscription Payment Failure Flow Flow v1.0.0 Flow for handling failed recurring subscription payments and recovery Owner subscriptions-management
View flow
View docs .