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

stripe-automation

NPX Install

SKILL.md Content

Stripe Automation via Rube MCP

Prerequisites

Setup

Core Workflows

1. Manage Customers

2. Manage Charges and Payments

3. Manage Subscriptions

4. Manage Invoices

5. Manage Products and Prices

6. Handle Refunds

Common Patterns

Amount Formatting

Pagination

Known Pitfalls

Quick Reference