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