Stripe Automation

1---
2name: stripe-automation
3description: "Automate Stripe tasks via Rube MCP (Composio): customers, charges, subscriptions, invoices, products, refunds. Always search tools first for current schemas."
4requires:
5  mcp: [rube]
6---
7 
8# Stripe Automation via Rube MCP
9 
10Automate Stripe payment operations through Composio's Stripe toolkit via Rube MCP.
11 
12## Prerequisites
13 
14- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
15- Active Stripe connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`
16- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
17 
18## Setup
19 
20**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
21 
22 
231. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
242. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`
253. If connection is not ACTIVE, follow the returned auth link to complete Stripe connection
264. Confirm connection status shows ACTIVE before running any workflows
27 
28## Core Workflows
29 
30### 1. Manage Customers
31 
32**When to use**: User wants to create, update, search, or list Stripe customers
33 
34**Tool sequence**:
351. `STRIPE_SEARCH_CUSTOMERS` - Search customers by email/name [Optional]
362. `STRIPE_LIST_CUSTOMERS` - List all customers [Optional]
373. `STRIPE_CREATE_CUSTOMER` - Create a new customer [Optional]
384. `STRIPE_POST_CUSTOMERS_CUSTOMER` - Update a customer [Optional]
39 
40**Key parameters**:
41- `email`: Customer email
42- `name`: Customer name
43- `description`: Customer description
44- `metadata`: Key-value metadata pairs
45- `customer`: Customer ID for updates (e.g., 'cus_xxx')
46 
47**Pitfalls**:
48- Stripe allows duplicate customers with the same email; search first to avoid duplicates
49- Customer IDs start with 'cus_'
50 
51### 2. Manage Charges and Payments
52 
53**When to use**: User wants to create charges, payment intents, or view charge history
54 
55**Tool sequence**:
561. `STRIPE_LIST_CHARGES` - List charges with filters [Optional]
572. `STRIPE_CREATE_PAYMENT_INTENT` - Create a payment intent [Optional]
583. `STRIPE_CONFIRM_PAYMENT_INTENT` - Confirm a payment intent [Optional]
594. `STRIPE_POST_CHARGES` - Create a direct charge [Optional]
605. `STRIPE_CAPTURE_CHARGE` - Capture an authorized charge [Optional]
61 
62**Key parameters**:
63- `amount`: Amount in smallest currency unit (e.g., cents for USD)
64- `currency`: Three-letter ISO currency code (e.g., 'usd')
65- `customer`: Customer ID
66- `payment_method`: Payment method ID
67- `description`: Charge description
68 
69**Pitfalls**:
70- Amounts are in smallest currency unit (100 = $1.00 for USD)
71- Currency codes must be lowercase (e.g., 'usd' not 'USD')
72- Payment intents are the recommended flow over direct charges
73 
74### 3. Manage Subscriptions
75 
76**When to use**: User wants to create, list, update, or cancel subscriptions
77 
78**Tool sequence**:
791. `STRIPE_LIST_SUBSCRIPTIONS` - List subscriptions [Optional]
802. `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` - Create subscription [Optional]
813. `STRIPE_RETRIEVE_SUBSCRIPTION` - Get subscription details [Optional]
824. `STRIPE_UPDATE_SUBSCRIPTION` - Modify subscription [Optional]
83 
84**Key parameters**:
85- `customer`: Customer ID
86- `items`: Array of price items (price_id and quantity)
87- `subscription`: Subscription ID for retrieval/update (e.g., 'sub_xxx')
88 
89**Pitfalls**:
90- Subscriptions require a valid customer with a payment method
91- Price IDs (not product IDs) are used for subscription items
92- Cancellation can be immediate or at period end
93 
94### 4. Manage Invoices
95 
96**When to use**: User wants to create, list, or search invoices
97 
98**Tool sequence**:
991. `STRIPE_LIST_INVOICES` - List invoices [Optional]
1002. `STRIPE_SEARCH_INVOICES` - Search invoices [Optional]
1013. `STRIPE_CREATE_INVOICE` - Create an invoice [Optional]
102 
103**Key parameters**:
104- `customer`: Customer ID for invoice
105- `collection_method`: 'charge_automatically' or 'send_invoice'
106- `days_until_due`: Days until invoice is due
107 
108**Pitfalls**:
109- Invoices auto-finalize by default; use `auto_advance: false` for draft invoices
110 
111### 5. Manage Products and Prices
112 
113**When to use**: User wants to list or search products and their pricing
114 
115**Tool sequence**:
1161. `STRIPE_LIST_PRODUCTS` - List products [Optional]
1172. `STRIPE_SEARCH_PRODUCTS` - Search products [Optional]
1183. `STRIPE_LIST_PRICES` - List prices [Optional]
1194. `STRIPE_GET_PRICES_SEARCH` - Search prices [Optional]
120 
121**Key parameters**:
122- `active`: Filter by active/inactive status
123- `query`: Search query for search endpoints
124 
125**Pitfalls**:
126- Products and prices are separate objects; a product can have multiple prices
127- Price IDs (e.g., 'price_xxx') are used for subscriptions and checkout
128 
129### 6. Handle Refunds
130 
131**When to use**: User wants to issue refunds on charges
132 
133**Tool sequence**:
1341. `STRIPE_LIST_REFUNDS` - List refunds [Optional]
1352. `STRIPE_POST_CHARGES_CHARGE_REFUNDS` - Create a refund [Optional]
1363. `STRIPE_CREATE_REFUND` - Create refund via payment intent [Optional]
137 
138**Key parameters**:
139- `charge`: Charge ID for refund
140- `amount`: Partial refund amount (omit for full refund)
141- `reason`: Refund reason ('duplicate', 'fraudulent', 'requested_by_customer')
142 
143**Pitfalls**:
144- Refunds can take 5-10 business days to appear on customer statements
145- Amount is in smallest currency unit
146 
147## Common Patterns
148 
149### Amount Formatting
150 
151Stripe uses smallest currency unit:
152- USD: $10.50 = 1050 cents
153- EUR: 10.50 = 1050 cents
154- JPY: 1000 = 1000 (no decimals)
155 
156### Pagination
157 
158- Use `limit` parameter (max 100)
159- Check `has_more` in response
160- Pass `starting_after` with last object ID for next page
161- Continue until `has_more` is false
162 
163## Known Pitfalls
164 
165**Amount Units**:
166- Always use smallest currency unit (cents for USD/EUR)
167- Zero-decimal currencies (JPY, KRW) use the amount directly
168 
169**ID Prefixes**:
170- Customers: `cus_`, Charges: `ch_`, Subscriptions: `sub_`
171- Invoices: `in_`, Products: `prod_`, Prices: `price_`
172- Payment Intents: `pi_`, Refunds: `re_`
173 
174## Quick Reference
175 
176| Task | Tool Slug | Key Params |
177|------|-----------|------------|
178| Create customer | STRIPE_CREATE_CUSTOMER | email, name |
179| Search customers | STRIPE_SEARCH_CUSTOMERS | query |
180| Update customer | STRIPE_POST_CUSTOMERS_CUSTOMER | customer, fields |
181| List charges | STRIPE_LIST_CHARGES | customer, limit |
182| Create payment intent | STRIPE_CREATE_PAYMENT_INTENT | amount, currency |
183| Confirm payment | STRIPE_CONFIRM_PAYMENT_INTENT | payment_intent |
184| List subscriptions | STRIPE_LIST_SUBSCRIPTIONS | customer |
185| Create subscription | STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS | customer, items |
186| Update subscription | STRIPE_UPDATE_SUBSCRIPTION | subscription, fields |
187| List invoices | STRIPE_LIST_INVOICES | customer |
188| Create invoice | STRIPE_CREATE_INVOICE | customer |
189| Search invoices | STRIPE_SEARCH_INVOICES | query |
190| List products | STRIPE_LIST_PRODUCTS | active |
191| Search products | STRIPE_SEARCH_PRODUCTS | query |
192| List prices | STRIPE_LIST_PRICES | product |
193| Search prices | STRIPE_GET_PRICES_SEARCH | query |
194| List refunds | STRIPE_LIST_REFUNDS | charge |
195| Create refund | STRIPE_CREATE_REFUND | charge, amount |
196| Payment methods | STRIPE_LIST_CUSTOMER_PAYMENT_METHODS | customer |
197| Checkout session | STRIPE_CREATE_CHECKOUT_SESSION | line_items |
198| List payment intents | STRIPE_LIST_PAYMENT_INTENTS | customer |
199