---

name: stripe-billing description: Stripe payment and billing operations with progressive disclosure allowed-tools: [Bash, Read]

Stripe Billing Skill

Overview

Provides 90%+ context savings compared to raw Stripe MCP server by loading only relevant operations on-demand.

Requirements

• STRIPE_SECRET_KEY environment variable (required)
• STRIPE_WEBHOOK_SECRET environment variable (optional, for webhooks)
• stripe Python package or Stripe CLI

Tools (Progressive Disclosure)

Customer Operations

| Tool | Description | Confirmation | |------|-------------|--------------| | list-customers | List customers with filters | No | | get-customer | Get customer details | No | | create-customer | Create new customer | Yes | | update-customer | Update customer info | Yes |

Subscription Operations

| Tool | Description | Confirmation | |------|-------------|--------------| | list-subscriptions | List subscriptions | No | | get-subscription | Get subscription details | No | | create-subscription | Create subscription | Yes | | cancel-subscription | Cancel subscription | Yes | | update-subscription | Modify subscription | Yes |

Invoice Operations

| Tool | Description | Confirmation | |------|-------------|--------------| | list-invoices | List invoices | No | | get-invoice | Get invoice details | No | | create-invoice | Create draft invoice | Yes | | finalize-invoice | Finalize invoice | Yes | | pay-invoice | Pay invoice | Yes |

Payment Operations

| Tool | Description | Confirmation | |------|-------------|--------------| | list-payments | List payment intents | No | | get-payment | Get payment details | No | | create-payment | Create payment intent | Yes | | confirm-payment | Confirm payment | Yes | | refund-payment | Issue refund | Yes |

Product/Price Operations

| Tool | Description | Confirmation | |------|-------------|--------------| | list-products | List products | No | | list-prices | List prices | No | | create-product | Create product | Yes | | create-price | Create price | Yes |

Quick Reference

# List customers
stripe customers list --limit 10

# Get subscription
stripe subscriptions retrieve sub_xxx

# Create payment intent
stripe payment_intents create --amount 2000 --currency usd

Configuration

• STRIPE_SECRET_KEY: API key (sk_test_xxx or sk_live_xxx)
• STRIPE_WEBHOOK_SECRET: Webhook signing secret (whsec_xxx)

Security

⚠️ NEVER expose API keys in logs or output ⚠️ Test mode keys (sk_test_) for development only ⚠️ All write operations require confirmation

Agent Integration

• developer (primary): Payment integrations
• analyst (secondary): Billing analytics

Troubleshooting

| Issue | Solution | |-------|----------| | Invalid API key | Check STRIPE_SECRET_KEY format | | Rate limited | Implement exponential backoff | | Webhook failed | Verify STRIPE_WEBHOOK_SECRET |