Stripe Automation Agent Skill

Stripe Automation via Rube MCP

Automate Stripe payment operations through Composio's Stripe toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/stripe

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 |

*Powered by Composio*