Open Skills Logo
Open Skills

stripe-automation

Automate Stripe tasks via Rube MCP (Composio): customers, charges, subscriptions, invoices, products, refunds. Always search tools first for current schemas.

View Source
name:stripe-automationdescription:"Automate Stripe tasks via Rube MCP (Composio): customers, charges, subscriptions, invoices, products, refunds. Always search tools first for current schemas."requires:mcp:[rube]

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

    TaskTool SlugKey Params
    Create customerSTRIPE_CREATE_CUSTOMERemail, name
    Search customersSTRIPE_SEARCH_CUSTOMERSquery
    Update customerSTRIPE_POST_CUSTOMERS_CUSTOMERcustomer, fields
    List chargesSTRIPE_LIST_CHARGEScustomer, limit
    Create payment intentSTRIPE_CREATE_PAYMENT_INTENTamount, currency
    Confirm paymentSTRIPE_CONFIRM_PAYMENT_INTENTpayment_intent
    List subscriptionsSTRIPE_LIST_SUBSCRIPTIONScustomer
    Create subscriptionSTRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONScustomer, items
    Update subscriptionSTRIPE_UPDATE_SUBSCRIPTIONsubscription, fields
    List invoicesSTRIPE_LIST_INVOICEScustomer
    Create invoiceSTRIPE_CREATE_INVOICEcustomer
    Search invoicesSTRIPE_SEARCH_INVOICESquery
    List productsSTRIPE_LIST_PRODUCTSactive
    Search productsSTRIPE_SEARCH_PRODUCTSquery
    List pricesSTRIPE_LIST_PRICESproduct
    Search pricesSTRIPE_GET_PRICES_SEARCHquery
    List refundsSTRIPE_LIST_REFUNDScharge
    Create refundSTRIPE_CREATE_REFUNDcharge, amount
    Payment methodsSTRIPE_LIST_CUSTOMER_PAYMENT_METHODScustomer
    Checkout sessionSTRIPE_CREATE_CHECKOUT_SESSIONline_items
    List payment intentsSTRIPE_LIST_PAYMENT_INTENTScustomer

      stripe-automation - Agent Skills