invoice-revenue-audit

用途

Invoice & Revenue Audit 是一个面向 Stripe 的发票与收入审查技能，用于检查已支付、未结、无法收回的发票，按周期汇总收入，并评估订阅计费的健康状况。当用户询问“发票”“计费”等相关问题时适用。

主要能力

• 按状态筛选发票：paid（已支付）、open（未结）、uncollectible（无法收回）、void（作废）。
• 汇总指定周期内已支付发票的 amount_paid，即实际收到的现金。
• 与 MRR 快照进行对比，用差额解释一次性费用、按比例计费（prorations）和信用额度（credits）等因素。
• 通过发票状态辅助判断业务信号，例如 uncollectible 可视为流失（churn）信号。

使用方式

1. 前置条件：需通过 OAuth 或受限密钥连接 Stripe MCP。文档地址：https://docs.stripe.com/mcp
2. 在任何调用之前，先使用 GetMcpTools，server 指定为 "user-Stripe"（或 plugin-stripe-stripe）。
3. 对于列表与检索操作，优先使用 stripe_api_search → stripe_api_details → stripe_api_read。
4. 始终分页：limit 设为 100，并根据 has_more 配合 starting_after 继续翻页。
5. 金额默认以分为单位，除非另有说明。
6. 输出中绝不暴露密钥。

工作流程

1. 调用 GetInvoices，按状态筛选：paid、open、uncollectible、void。
2. 对周期内已支付发票的 amount_paid 求和，得到现金收款额。
3. 与 MRR 快照对比，用差额解释一次性费用、按比例计费和信用额度。

状态含义与建议动作

• open：等待付款，应检查 past_due 的订阅。
• paid：已收款。
• uncollectible：坏账核销，是流失信号。
• void：已取消的发票。

输出模板

Invoice Summary ([period])

Paid: $[X] ([n] invoices) Open: $[Y] ([n]) Uncollectible: $[Z]

vs MRR snapshot: [explain delta]

适用场景

• 需要按周期核对 Stripe 实际收款与 MRR 差异时。
• 需要识别未结发票、坏账核销与订阅计费异常时。
• 需要快速生成发票与收入摘要时。

限制

• 依赖 Stripe MCP 连接，需具备相应访问权限。
• 金额单位默认为分，需注意换算。
• 关于收费、价格、平台支持范围等更多信息，资料暂未提供。