revclamp_evaluate_ghost_usage
Checks if a metered API/SaaS usage event belongs to an entitled customer or is post-cancellation/post-grace ghost usage under Stripe 2025-03-31.basil.
Instructions
Evaluates whether a metered API/SaaS usage event belongs to an entitled customer or represents post-cancellation / post-grace ghost usage under Stripe 2025-03-31.basil.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "revclamp_evaluate_ghost_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| demo | No | ||
| timestamp | No | Optional alias for occurredAt (ISO-8601 string, Unix epoch seconds, or Unix epoch milliseconds). | |
| customerId | No | Optional Stripe customer identifier to evaluate (e.g. 'cus_9s6XKzkNRiz8i3', max 64 chars). | |
| occurredAt | No | Optional usage event timestamp as ISO-8601 string, Unix epoch seconds, or Unix epoch milliseconds. | |
| usageEvent | No | Optional metered usage event with customer_id, event_name, occurred_at (or occurred_at_sec). | |
| occurred_at | No | Optional snake_case alias for occurredAt (ISO-8601 string, Unix epoch seconds, or Unix epoch milliseconds). | |
| occurredAtSec | No | Optional alias for usageTimestampSec (Unix epoch seconds, Unix epoch milliseconds, or ISO-8601 string). | |
| subscriptions | No | Stripe subscriptions list envelope ({ data: [...], has_more: false }) or raw array of subscription objects. | |
| currentPeriodEnd | No | Optional camelCase alias for current_period_end (Unix epoch seconds, epoch milliseconds, or ISO-8601 string). | |
| usageTimestampSec | No | Optional usage event timestamp as Unix epoch seconds, Unix epoch milliseconds, or ISO-8601 string. | |
| current_period_end | No | Optional flat subscription current_period_end (Unix epoch seconds, epoch milliseconds, or ISO-8601 string). | |
| subscriptionStatus | No | Optional flat Stripe subscription status shorthand ('active', 'trialing', 'past_due', 'canceled', 'unpaid', 'incomplete', 'incomplete_expired', 'paused') when subscriptions is omitted. | |
| currentPeriodEndSec | No | Optional flat subscription current_period_end in Unix epoch integer seconds. | |
| subscription_status | No | Optional snake_case alias for subscriptionStatus. | |
| subscriptionsHasMore | No | Pagination completeness flag (must be false when passing a raw subscriptions array). | |
| dunningGracePeriodDays | No | ||
| latestInvoiceFailedAtSec | No | Optional flat latest_invoice_failed_at timestamp in Unix epoch integer seconds for past_due grace evaluation. | |
| latest_invoice_failed_at | No | Optional flat latest_invoice_failed_at timestamp (Unix epoch seconds, epoch milliseconds, or ISO-8601 string). |