Stripe Automation via Rube MCP
Automate Stripe payment operations through Composio's Stripe toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Stripe connection via
RUBE_MANAGE_CONNECTIONS with toolkit stripe
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
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.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit stripe
- If connection is not ACTIVE, follow the returned auth link to complete Stripe connection
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Manage Customers
When to use: User wants to create, update, search, or list Stripe customers
Tool sequence:
STRIPE_SEARCH_CUSTOMERS - Search customers by email/name [Optional]
STRIPE_LIST_CUSTOMERS - List all customers [Optional]
STRIPE_CREATE_CUSTOMER - Create a new customer [Optional]
STRIPE_POST_CUSTOMERS_CUSTOMER - Update a customer [Optional]
Key parameters:
email: Customer email
name: Customer name
description: Customer description
metadata: Key-value metadata pairs
customer: Customer ID for updates (e.g., 'cus_xxx')
Pitfalls:
- Stripe allows duplicate customers with the same email; search first to avoid duplicates
- Customer IDs start with 'cus_'
2. Manage Charges and Payments
When to use: User wants to create charges, payment intents, or view charge history
Tool sequence:
STRIPE_LIST_CHARGES - List charges with filters [Optional]
STRIPE_CREATE_PAYMENT_INTENT - Create a payment intent [Optional]
STRIPE_CONFIRM_PAYMENT_INTENT - Confirm a payment intent [Optional]
STRIPE_POST_CHARGES - Create a direct charge [Optional]
STRIPE_CAPTURE_CHARGE - Capture an authorized charge [Optional]
Key parameters:
amount: Amount in smallest currency unit (e.g., cents for USD)
currency: Three-letter ISO currency code (e.g., 'usd')
customer: Customer ID
payment_method: Payment method ID
description: Charge description
Pitfalls:
- Amounts are in smallest currency unit (100 = $1.00 for USD)
- Currency codes must be lowercase (e.g., 'usd' not 'USD')
- Payment intents are the recommended flow over direct charges
3. Manage Subscriptions
When to use: User wants to create, list, update, or cancel subscriptions
Tool sequence:
STRIPE_LIST_SUBSCRIPTIONS - List subscriptions [Optional]
STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS - Create subscription [Optional]
STRIPE_RETRIEVE_SUBSCRIPTION - Get subscription details [Optional]
STRIPE_UPDATE_SUBSCRIPTION - Modify subscription [Optional]
Key parameters:
customer: Customer ID
items: Array of price items (price_id and quantity)
subscription: Subscription ID for retrieval/update (e.g., 'sub_xxx')
Pitfalls:
- Subscriptions require a valid customer with a payment method
- Price IDs (not product IDs) are used for subscription items
- Cancellation can be immediate or at period end
4. Manage Invoices
When to use: User wants to create, list, or search invoices
Tool sequence:
STRIPE_LIST_INVOICES - List invoices [Optional]
STRIPE_SEARCH_INVOICES - Search invoices [Optional]
STRIPE_CREATE_INVOICE - Create an invoice [Optional]
Key parameters:
customer: Customer ID for invoice
collection_method: 'charge_automatically' or 'send_invoice'
days_until_due: Days until invoice is due
Pitfalls:
- Invoices auto-finalize by default; use
auto_advance: false for draft invoices
5. Manage Products and Prices
When to use: User wants to list or search products and their pricing
Tool sequence:
STRIPE_LIST_PRODUCTS - List products [Optional]
STRIPE_SEARCH_PRODUCTS - Search products [Optional]
STRIPE_LIST_PRICES - List prices [Optional]
STRIPE_GET_PRICES_SEARCH - Search prices [Optional]
Key parameters:
active: Filter by active/inactive status
query: Search query for search endpoints
Pitfalls:
- Products and prices are separate objects; a product can have multiple prices
- Price IDs (e.g., 'price_xxx') are used for subscriptions and checkout
6. Handle Refunds
When to use: User wants to issue refunds on charges
Tool sequence:
STRIPE_LIST_REFUNDS - List refunds [Optional]
STRIPE_POST_CHARGES_CHARGE_REFUNDS - Create a refund [Optional]
STRIPE_CREATE_REFUND - Create refund via payment intent [Optional]
Key parameters:
charge: Charge ID for refund
amount: Partial refund amount (omit for full refund)
reason: Refund reason ('duplicate', 'fraudulent', 'requested_by_customer')
Pitfalls:
- Refunds can take 5-10 business days to appear on customer statements
- Amount is in smallest currency unit
Common Patterns
Amount Formatting
Stripe uses smallest currency unit:
- USD: $10.50 = 1050 cents
- EUR: 10.50 = 1050 cents
- JPY: 1000 = 1000 (no decimals)
Pagination
- Use
limit parameter (max 100)
- Check
has_more in response
- Pass
starting_after with last object ID for next page
- Continue until
has_more is false
Known Pitfalls
Amount Units:
- Always use smallest currency unit (cents for USD/EUR)
- Zero-decimal currencies (JPY, KRW) use the amount directly
ID Prefixes:
- Customers:
cus_, Charges: ch_, Subscriptions: sub_
- Invoices:
in_, Products: prod_, Prices: price_
- Payment Intents:
pi_, Refunds: re_
Quick Reference
| Task |
Tool Slug |
Key Params |
| Create customer |
STRIPE_CREATE_CUSTOMER |
email, name |
| Search customers |
STRIPE_SEARCH_CUSTOMERS |
query |
| Update customer |
STRIPE_POST_CUSTOMERS_CUSTOMER |
customer, fields |
| List charges |
STRIPE_LIST_CHARGES |
customer, limit |
| Create payment intent |
STRIPE_CREATE_PAYMENT_INTENT |
amount, currency |
| Confirm payment |
STRIPE_CONFIRM_PAYMENT_INTENT |
payment_intent |
| List subscriptions |
STRIPE_LIST_SUBSCRIPTIONS |
customer |
| Create subscription |
STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS |
customer, items |
| Update subscription |
STRIPE_UPDATE_SUBSCRIPTION |
subscription, fields |
| List invoices |
STRIPE_LIST_INVOICES |
customer |
| Create invoice |
STRIPE_CREATE_INVOICE |
customer |
| Search invoices |
STRIPE_SEARCH_INVOICES |
query |
| List products |
STRIPE_LIST_PRODUCTS |
active |
| Search products |
STRIPE_SEARCH_PRODUCTS |
query |
| List prices |
STRIPE_LIST_PRICES |
product |
| Search prices |
STRIPE_GET_PRICES_SEARCH |
query |
| List refunds |
STRIPE_LIST_REFUNDS |
charge |
| Create refund |
STRIPE_CREATE_REFUND |
charge, amount |
| Payment methods |
STRIPE_LIST_CUSTOMER_PAYMENT_METHODS |
customer |
| Checkout session |
STRIPE_CREATE_CHECKOUT_SESSION |
line_items |
| List payment intents |
STRIPE_LIST_PAYMENT_INTENTS |
customer |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: stripe-automation3description: 'Automate Stripe tasks via Rube MCP (Composio): customers, charges, subscriptions, invoices, products, refunds. Always search tools first for current schemas.'4metadata:5 source: https://skillmd.com/skills/iradoweck/stripe-automation6 aas-risk: critical7 aas-source: community8 aas-date-added: '2026-02-27'9---1011# Stripe Automation via Rube MCP1213Automate Stripe payment operations through Composio's Stripe toolkit via Rube MCP.1415## Prerequisites1617- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)18- Active Stripe connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`19- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2021## Setup2223**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.24251. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds262. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`273. If connection is not ACTIVE, follow the returned auth link to complete Stripe connection284. Confirm connection status shows ACTIVE before running any workflows2930## Core Workflows3132### 1. Manage Customers3334**When to use**: User wants to create, update, search, or list Stripe customers3536**Tool sequence**:371. `STRIPE_SEARCH_CUSTOMERS` - Search customers by email/name [Optional]382. `STRIPE_LIST_CUSTOMERS` - List all customers [Optional]393. `STRIPE_CREATE_CUSTOMER` - Create a new customer [Optional]404. `STRIPE_POST_CUSTOMERS_CUSTOMER` - Update a customer [Optional]4142**Key parameters**:43- `email`: Customer email44- `name`: Customer name45- `description`: Customer description46- `metadata`: Key-value metadata pairs47- `customer`: Customer ID for updates (e.g., 'cus_xxx')4849**Pitfalls**:50- Stripe allows duplicate customers with the same email; search first to avoid duplicates51- Customer IDs start with 'cus_'5253### 2. Manage Charges and Payments5455**When to use**: User wants to create charges, payment intents, or view charge history5657**Tool sequence**:581. `STRIPE_LIST_CHARGES` - List charges with filters [Optional]592. `STRIPE_CREATE_PAYMENT_INTENT` - Create a payment intent [Optional]603. `STRIPE_CONFIRM_PAYMENT_INTENT` - Confirm a payment intent [Optional]614. `STRIPE_POST_CHARGES` - Create a direct charge [Optional]625. `STRIPE_CAPTURE_CHARGE` - Capture an authorized charge [Optional]6364**Key parameters**:65- `amount`: Amount in smallest currency unit (e.g., cents for USD)66- `currency`: Three-letter ISO currency code (e.g., 'usd')67- `customer`: Customer ID68- `payment_method`: Payment method ID69- `description`: Charge description7071**Pitfalls**:72- Amounts are in smallest currency unit (100 = $1.00 for USD)73- Currency codes must be lowercase (e.g., 'usd' not 'USD')74- Payment intents are the recommended flow over direct charges7576### 3. Manage Subscriptions7778**When to use**: User wants to create, list, update, or cancel subscriptions7980**Tool sequence**:811. `STRIPE_LIST_SUBSCRIPTIONS` - List subscriptions [Optional]822. `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` - Create subscription [Optional]833. `STRIPE_RETRIEVE_SUBSCRIPTION` - Get subscription details [Optional]844. `STRIPE_UPDATE_SUBSCRIPTION` - Modify subscription [Optional]8586**Key parameters**:87- `customer`: Customer ID88- `items`: Array of price items (price_id and quantity)89- `subscription`: Subscription ID for retrieval/update (e.g., 'sub_xxx')9091**Pitfalls**:92- Subscriptions require a valid customer with a payment method93- Price IDs (not product IDs) are used for subscription items94- Cancellation can be immediate or at period end9596### 4. Manage Invoices9798**When to use**: User wants to create, list, or search invoices99100**Tool sequence**:1011. `STRIPE_LIST_INVOICES` - List invoices [Optional]1022. `STRIPE_SEARCH_INVOICES` - Search invoices [Optional]1033. `STRIPE_CREATE_INVOICE` - Create an invoice [Optional]104105**Key parameters**:106- `customer`: Customer ID for invoice107- `collection_method`: 'charge_automatically' or 'send_invoice'108- `days_until_due`: Days until invoice is due109110**Pitfalls**:111- Invoices auto-finalize by default; use `auto_advance: false` for draft invoices112113### 5. Manage Products and Prices114115**When to use**: User wants to list or search products and their pricing116117**Tool sequence**:1181. `STRIPE_LIST_PRODUCTS` - List products [Optional]1192. `STRIPE_SEARCH_PRODUCTS` - Search products [Optional]1203. `STRIPE_LIST_PRICES` - List prices [Optional]1214. `STRIPE_GET_PRICES_SEARCH` - Search prices [Optional]122123**Key parameters**:124- `active`: Filter by active/inactive status125- `query`: Search query for search endpoints126127**Pitfalls**:128- Products and prices are separate objects; a product can have multiple prices129- Price IDs (e.g., 'price_xxx') are used for subscriptions and checkout130131### 6. Handle Refunds132133**When to use**: User wants to issue refunds on charges134135**Tool sequence**:1361. `STRIPE_LIST_REFUNDS` - List refunds [Optional]1372. `STRIPE_POST_CHARGES_CHARGE_REFUNDS` - Create a refund [Optional]1383. `STRIPE_CREATE_REFUND` - Create refund via payment intent [Optional]139140**Key parameters**:141- `charge`: Charge ID for refund142- `amount`: Partial refund amount (omit for full refund)143- `reason`: Refund reason ('duplicate', 'fraudulent', 'requested_by_customer')144145**Pitfalls**:146- Refunds can take 5-10 business days to appear on customer statements147- Amount is in smallest currency unit148149## Common Patterns150151### Amount Formatting152153Stripe uses smallest currency unit:154- USD: $10.50 = 1050 cents155- EUR: 10.50 = 1050 cents156- JPY: 1000 = 1000 (no decimals)157158### Pagination159160- Use `limit` parameter (max 100)161- Check `has_more` in response162- Pass `starting_after` with last object ID for next page163- Continue until `has_more` is false164165## Known Pitfalls166167**Amount Units**:168- Always use smallest currency unit (cents for USD/EUR)169- Zero-decimal currencies (JPY, KRW) use the amount directly170171**ID Prefixes**:172- Customers: `cus_`, Charges: `ch_`, Subscriptions: `sub_`173- Invoices: `in_`, Products: `prod_`, Prices: `price_`174- Payment Intents: `pi_`, Refunds: `re_`175176## Quick Reference177178| Task | Tool Slug | Key Params |179|------|-----------|------------|180| Create customer | STRIPE_CREATE_CUSTOMER | email, name |181| Search customers | STRIPE_SEARCH_CUSTOMERS | query |182| Update customer | STRIPE_POST_CUSTOMERS_CUSTOMER | customer, fields |183| List charges | STRIPE_LIST_CHARGES | customer, limit |184| Create payment intent | STRIPE_CREATE_PAYMENT_INTENT | amount, currency |185| Confirm payment | STRIPE_CONFIRM_PAYMENT_INTENT | payment_intent |186| List subscriptions | STRIPE_LIST_SUBSCRIPTIONS | customer |187| Create subscription | STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS | customer, items |188| Update subscription | STRIPE_UPDATE_SUBSCRIPTION | subscription, fields |189| List invoices | STRIPE_LIST_INVOICES | customer |190| Create invoice | STRIPE_CREATE_INVOICE | customer |191| Search invoices | STRIPE_SEARCH_INVOICES | query |192| List products | STRIPE_LIST_PRODUCTS | active |193| Search products | STRIPE_SEARCH_PRODUCTS | query |194| List prices | STRIPE_LIST_PRICES | product |195| Search prices | STRIPE_GET_PRICES_SEARCH | query |196| List refunds | STRIPE_LIST_REFUNDS | charge |197| Create refund | STRIPE_CREATE_REFUND | charge, amount |198| Payment methods | STRIPE_LIST_CUSTOMER_PAYMENT_METHODS | customer |199| Checkout session | STRIPE_CREATE_CHECKOUT_SESSION | line_items |200| List payment intents | STRIPE_LIST_PAYMENT_INTENTS | customer |201202## When to Use203This skill is applicable to execute the workflow or actions described in the overview.204205## Limitations206- Use this skill only when the task clearly matches the scope described above.207- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.208- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.