majiayu000 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 |