Stripe Automation

# 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.

1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds

2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`

3. If connection is not ACTIVE, follow the returned auth link to complete Stripe connection

4. 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**:

1. `STRIPE_SEARCH_CUSTOMERS` - Search customers by email/name [Optional]

2. `STRIPE_LIST_CUSTOMERS` - List all customers [Optional]

3. `STRIPE_CREATE_CUSTOMER` - Create a new customer [Optional]

4. `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**:

1. `STRIPE_LIST_CHARGES` - List charges with filters [Optional]

2. `STRIPE_CREATE_PAYMENT_INTENT` - Create a payment intent [Optional]

3. `STRIPE_CONFIRM_PAYMENT_INTENT` - Confirm a payment intent [Optional]

4. `STRIPE_POST_CHARGES` - Create a direct charge [Optional]

5. `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**:

1. `STRIPE_LIST_SUBSCRIPTIONS` - List subscriptions [Optional]

2. `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` - Create subscription [Optional]

3. `STRIPE_RETRIEVE_SUBSCRIPTION` - Get subscription details [Optional]

4. `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**:

1. `STRIPE_LIST_INVOICES` - List invoices [Optional]

2. `STRIPE_SEARCH_INVOICES` - Search invoices [Optional]

3. `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**:

1. `STRIPE_LIST_PRODUCTS` - List products [Optional]

2. `STRIPE_SEARCH_PRODUCT