Stripe

Stripe MCP Server for Cloudflare Workers

Available Tools

110 tools available in the Stripe MCP server. Each tool can be called by AI assistants to perform specific actions.

stripe_get_invoice

Get an invoice by ID.

Args:

invoice_id: The Invoice ID (in_...)

Returns: The invoice details.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    }
  }
}

stripe_delete_product

Delete a product.

Args:

product_id: The Product ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID"
    }
  }
}

stripe_delete_account

Delete a connected account.

Args:

account_id: The Account ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "account_id"
  ],
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account ID"
    }
  }
}

stripe_get_balance

Get the current account balance.

Returns the balance currently available in the Stripe account, including available and pending amounts by currency.

Returns: Balance with available and pending amounts.

{
  "type": "object",
  "properties": {}
}

stripe_list_balance_transactions

List balance transactions with pagination.

Balance transactions show funds moving through your Stripe account, including payments, transfers, fees, and adjustments.

Args:

limit: Number of results (1-100)
starting_after: Balance transaction ID for pagination
type: Filter by type (charge, refund, adjustment, etc.)

Returns: List of balance transactions

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Transaction type filter"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_balance_transaction

Get a balance transaction by ID.

Args:

transaction_id: The Balance Transaction ID (txn_...)

Returns: The balance transaction details.

{
  "type": "object",
  "required": [
    "transaction_id"
  ],
  "properties": {
    "transaction_id": {
      "type": "string",
      "description": "Balance Transaction ID"
    }
  }
}

stripe_update_transfer

Update a transfer.

Args:

transfer_id: The Transfer ID
description: New description
metadata: New metadata

Returns: The updated transfer.

{
  "type": "object",
  "required": [
    "transfer_id"
  ],
  "properties": {
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "transfer_id": {
      "type": "string",
      "description": "Transfer ID"
    }
  }
}

stripe_list_events

List events (webhooks) with pagination.

Events represent things that happened in your account, like payment succeeded, subscription created, etc.

Args:

limit: Number of results (1-100)
starting_after: Event ID for pagination
type: Filter by event type (e.g., "payment_intent.succeeded")
created_gte: Filter by created timestamp (Unix, greater than or equal)
created_lte: Filter by created timestamp (Unix, less than or equal)

Returns: List of events

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Event type filter"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "created_gte": {
      "type": "integer",
      "description": "Created after timestamp"
    },
    "created_lte": {
      "type": "integer",
      "description": "Created before timestamp"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_event

Get an event by ID.

Args:

event_id: The Event ID (evt_...)

Returns: The event details including the associated data object.

{
  "type": "object",
  "required": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "description": "Event ID"
    }
  }
}

stripe_list_coupons

List coupons with pagination.

Args:

limit: Number of results (1-100)
starting_after: Coupon ID for pagination

Returns: List of coupons

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_coupon

Get a coupon by ID.

Args:

coupon_id: The Coupon ID

Returns: The coupon details.

{
  "type": "object",
  "required": [
    "coupon_id"
  ],
  "properties": {
    "coupon_id": {
      "type": "string",
      "description": "Coupon ID"
    }
  }
}

stripe_create_coupon

Create a new coupon.

Args:

id: Custom coupon ID (optional)
percent_off: Percentage discount (use this OR amount_off)
amount_off: Fixed amount discount in cents (use this OR percent_off)
currency: Currency for amount_off
duration: "forever", "once", or "repeating"
duration_in_months: Months for repeating coupons
max_redemptions: Maximum times coupon can be used
name: Coupon name
redeem_by: Unix timestamp expiration date
metadata: Custom metadata

Returns: The created coupon.

{
  "type": "object",
  "required": [
    "duration"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "duration": {
      "enum": [
        "forever",
        "once",
        "repeating"
      ],
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "redeem_by": {
      "type": "integer"
    },
    "amount_off": {
      "type": "integer"
    },
    "percent_off": {
      "type": "number"
    },
    "max_redemptions": {
      "type": "integer"
    },
    "duration_in_months": {
      "type": "integer"
    }
  }
}

stripe_update_coupon

Update a coupon.

Args:

coupon_id: The Coupon ID
name: New name
metadata: New metadata

Returns: The updated coupon.

{
  "type": "object",
  "required": [
    "coupon_id"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "coupon_id": {
      "type": "string",
      "description": "Coupon ID"
    }
  }
}

stripe_delete_coupon

Delete a coupon.

Args:

coupon_id: The Coupon ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "coupon_id"
  ],
  "properties": {
    "coupon_id": {
      "type": "string",
      "description": "Coupon ID"
    }
  }
}

stripe_list_promotion_codes

List promotion codes with pagination.

Args:

limit: Number of results
starting_after: Promotion code ID for pagination
active: Filter by active status
coupon: Filter by coupon ID
code: Filter by exact code

Returns: List of promotion codes

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "active": {
      "type": "boolean"
    },
    "coupon": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_promotion_code

Get a promotion code by ID.

Args:

promotion_code_id: The Promotion Code ID (promo_...)

Returns: The promotion code details.

{
  "type": "object",
  "required": [
    "promotion_code_id"
  ],
  "properties": {
    "promotion_code_id": {
      "type": "string",
      "description": "Promotion Code ID"
    }
  }
}

stripe_list_transfers

List transfers with pagination.

Args:

limit: Number of results
starting_after: Transfer ID for pagination
destination: Filter by destination account ID

Returns: List of transfers

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "destination": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_create_promotion_code

Create a promotion code for a coupon.

Args:

coupon: Coupon ID (required)
code: Custom code string (optional, auto-generated if not provided)
active: Whether the code is active
customer: Restrict to specific customer
expires_at: Unix timestamp expiration
max_redemptions: Maximum redemptions
metadata: Custom metadata

Returns: The created promotion code.

{
  "type": "object",
  "required": [
    "coupon"
  ],
  "properties": {
    "code": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "coupon": {
      "type": "string",
      "description": "Coupon ID"
    },
    "customer": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "expires_at": {
      "type": "integer"
    },
    "max_redemptions": {
      "type": "integer"
    }
  }
}

stripe_update_promotion_code

Update a promotion code.

Args:

promotion_code_id: The Promotion Code ID
active: New active status
metadata: New metadata

Returns: The updated promotion code.

{
  "type": "object",
  "required": [
    "promotion_code_id"
  ],
  "properties": {
    "active": {
      "type": "boolean"
    },
    "metadata": {
      "type": "object"
    },
    "promotion_code_id": {
      "type": "string",
      "description": "Promotion Code ID"
    }
  }
}

stripe_list_tax_rates

List tax rates with pagination.

Args:

limit: Number of results
starting_after: Tax rate ID for pagination
active: Filter by active status

Returns: List of tax rates

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "active": {
      "type": "boolean"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_tax_rate

Get a tax rate by ID.

Args:

tax_rate_id: The Tax Rate ID (txr_...)

Returns: The tax rate details.

{
  "type": "object",
  "required": [
    "tax_rate_id"
  ],
  "properties": {
    "tax_rate_id": {
      "type": "string",
      "description": "Tax Rate ID"
    }
  }
}

stripe_create_tax_rate

Create a new tax rate.

Args:

display_name: Display name (required)
percentage: Tax percentage (required)
inclusive: Whether tax is inclusive (required)
active: Whether tax rate is active
country: Country code
description: Description
jurisdiction: Jurisdiction name
state: State code
metadata: Custom metadata

Returns: The created tax rate.

{
  "type": "object",
  "required": [
    "display_name",
    "percentage",
    "inclusive"
  ],
  "properties": {
    "state": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "country": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "inclusive": {
      "type": "boolean",
      "description": "Tax inclusive"
    },
    "percentage": {
      "type": "number",
      "description": "Tax percentage"
    },
    "description": {
      "type": "string"
    },
    "display_name": {
      "type": "string",
      "description": "Display name"
    },
    "jurisdiction": {
      "type": "string"
    }
  }
}

stripe_update_tax_rate

Update a tax rate.

Args:

tax_rate_id: The Tax Rate ID
active: New active status
description: New description
display_name: New display name
metadata: New metadata

Returns: The updated tax rate.

{
  "type": "object",
  "required": [
    "tax_rate_id"
  ],
  "properties": {
    "active": {
      "type": "boolean"
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "tax_rate_id": {
      "type": "string",
      "description": "Tax Rate ID"
    },
    "display_name": {
      "type": "string"
    }
  }
}

stripe_list_checkout_sessions

List checkout sessions with pagination.

Args:

limit: Number of results
starting_after: Session ID for pagination
customer: Filter by customer ID
payment_intent: Filter by PaymentIntent ID
subscription: Filter by subscription ID

Returns: List of checkout sessions

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "customer": {
      "type": "string"
    },
    "subscription": {
      "type": "string"
    },
    "payment_intent": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_checkout_session

Get a checkout session by ID.

Args:

session_id: The Checkout Session ID (cs_...)

Returns: The checkout session details.

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Checkout Session ID"
    }
  }
}

stripe_create_checkout_session

Create a checkout session for hosted payment page.

Args:

mode: "payment", "setup", or "subscription" (required)
success_url: Redirect URL after success
cancel_url: Redirect URL after cancel
line_items: Array of items to purchase
customer: Existing customer ID
customer_email: Customer email (for new customers)
metadata: Custom metadata
payment_method_types: Allowed payment methods
allow_promotion_codes: Allow promo codes

Returns: The created checkout session with URL.

{
  "type": "object",
  "required": [
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "payment",
        "setup",
        "subscription"
      ],
      "type": "string"
    },
    "customer": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "cancel_url": {
      "type": "string"
    },
    "success_url": {
      "type": "string"
    },
    "customer_email": {
      "type": "string"
    },
    "payment_method_types": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "allow_promotion_codes": {
      "type": "boolean"
    }
  }
}

stripe_expire_checkout_session

Expire a checkout session.

Args:

session_id: The Checkout Session ID

Returns: The expired session.

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Checkout Session ID"
    }
  }
}

stripe_list_accounts

List connected accounts with pagination.

Args:

limit: Number of results (1-100)
starting_after: Account ID for pagination

Returns: List of connected accounts

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_account

Get a connected account by ID.

Args:

account_id: The Account ID (acct_...)

Returns: The account details.

{
  "type": "object",
  "required": [
    "account_id"
  ],
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account ID"
    }
  }
}

stripe_create_account

Create a connected account.

Args:

type: Account type ("custom", "express", or "standard")
country: Two-letter country code
email: Account holder email
capabilities: Requested capabilities
business_type: "company", "individual", etc.
metadata: Custom metadata

Returns: The created account.

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "custom",
        "express",
        "standard"
      ],
      "type": "string"
    },
    "email": {
      "type": "string",
      "description": "Capabilities to request"
    },
    "country": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "business_type": {
      "enum": [
        "company",
        "government_entity",
        "individual",
        "non_profit"
      ],
      "type": "string"
    }
  }
}

stripe_update_account

Update a connected account.

Args:

account_id: The Account ID
email: New email
metadata: New metadata
business_profile: Business profile updates

Returns: The updated account.

{
  "type": "object",
  "required": [
    "account_id"
  ],
  "properties": {
    "email": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "account_id": {
      "type": "string",
      "description": "Account ID"
    }
  }
}

stripe_get_transfer

Get a transfer by ID.

Args:

transfer_id: The Transfer ID (tr_...)

Returns: The transfer details.

{
  "type": "object",
  "required": [
    "transfer_id"
  ],
  "properties": {
    "transfer_id": {
      "type": "string",
      "description": "Transfer ID"
    }
  }
}

stripe_create_transfer

Create a transfer to a connected account.

Args:

amount: Amount in cents (required)
currency: Currency code (required)
destination: Destination account ID (required)
description: Description
metadata: Custom metadata
source_transaction: Source charge/payment
transfer_group: Transfer group ID

Returns: The created transfer.

{
  "type": "object",
  "required": [
    "amount",
    "currency",
    "destination"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount in cents"
    },
    "currency": {
      "type": "string",
      "description": "Currency code"
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "destination": {
      "type": "string",
      "description": "Destination account ID"
    },
    "transfer_group": {
      "type": "string"
    },
    "source_transaction": {
      "type": "string"
    }
  }
}

stripe_list_payouts

List payouts with pagination.

Args:

limit: Number of results
starting_after: Payout ID for pagination
status: Filter by status (pending, paid, failed, canceled)

Returns: List of payouts

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "status": {
      "enum": [
        "pending",
        "paid",
        "failed",
        "canceled"
      ],
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_payout

Get a payout by ID.

Args:

payout_id: The Payout ID (po_...)

Returns: The payout details.

{
  "type": "object",
  "required": [
    "payout_id"
  ],
  "properties": {
    "payout_id": {
      "type": "string",
      "description": "Payout ID"
    }
  }
}

stripe_create_payout

Create a payout to your bank account.

Args:

amount: Amount in cents (required)
currency: Currency code (required)
description: Description
destination: Destination bank account/card ID
metadata: Custom metadata
method: "standard" or "instant"

Returns: The created payout.

{
  "type": "object",
  "required": [
    "amount",
    "currency"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount in cents"
    },
    "method": {
      "enum": [
        "standard",
        "instant"
      ],
      "type": "string"
    },
    "currency": {
      "type": "string",
      "description": "Currency code"
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "destination": {
      "type": "string"
    }
  }
}

stripe_cancel_payout

Cancel a pending payout.

Args:

payout_id: The Payout ID

Returns: The canceled payout.

{
  "type": "object",
  "required": [
    "payout_id"
  ],
  "properties": {
    "payout_id": {
      "type": "string",
      "description": "Payout ID"
    }
  }
}

stripe_reverse_payout

Reverse a payout (returns funds to Stripe balance).

Args:

payout_id: The Payout ID
metadata: Custom metadata

Returns: The reversed payout.

{
  "type": "object",
  "required": [
    "payout_id"
  ],
  "properties": {
    "metadata": {
      "type": "object"
    },
    "payout_id": {
      "type": "string",
      "description": "Payout ID"
    }
  }
}

stripe_list_customers

List customers from Stripe with pagination.

Returns a paginated list of customers. Use starting_after from the last customer to fetch the next page.

Args:

limit: Number of customers to return (1-100, default: 10)
starting_after: Customer ID to start after for pagination
email: Filter by email address

Returns: List of customers with pagination info

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Filter by email address"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of customers to return"
    },
    "starting_after": {
      "type": "string",
      "description": "Customer ID for pagination"
    }
  }
}

stripe_get_customer

Get a single customer by ID.

Args:

customer_id: The Stripe customer ID (cus_...)

Returns: The customer record with all available fields.

{
  "type": "object",
  "required": [
    "customer_id"
  ],
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Stripe customer ID"
    }
  }
}

stripe_create_customer

Create a new customer in Stripe.

Args:

email: Email address
name: Customer name
phone: Phone number
description: Description of the customer
metadata: Key-value pairs for custom data

Returns: The created customer record.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Customer name"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "metadata": {
      "type": "object",
      "description": "Custom metadata"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

stripe_update_customer

Update an existing customer.

Args:

customer_id: The Stripe customer ID to update
email: New email address
name: New name
phone: New phone number
description: New description
metadata: New metadata (replaces existing)

Returns: The updated customer record.

{
  "type": "object",
  "required": [
    "customer_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Customer name"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "metadata": {
      "type": "object",
      "description": "Custom metadata"
    },
    "customer_id": {
      "type": "string",
      "description": "Stripe customer ID"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

stripe_delete_customer

Delete a customer from Stripe.

Args:

customer_id: The Stripe customer ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "customer_id"
  ],
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Stripe customer ID"
    }
  }
}

stripe_search_customers

Search for customers using Stripe's search syntax.

Query syntax examples:

email:"test@example.com"
name~"John"
metadata["key"]:"value"
created>1609459200

Args:

query: Search query string
limit: Maximum results to return

Returns: List of matching customers.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results"
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_payment_intents

List payment intents with pagination.

Args:

limit: Number of results (1-100, default: 10)
starting_after: PaymentIntent ID for pagination
customer: Filter by customer ID

Returns: List of payment intents

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "customer": {
      "type": "string",
      "description": "Filter by customer ID"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_list_invoices

List invoices with pagination.

Args:

limit: Number of results (1-100)
starting_after: Invoice ID for pagination
customer: Filter by customer ID
subscription: Filter by subscription ID
status: Filter by status (draft, open, paid, uncollectible, void)

Returns: List of invoices

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "status": {
      "enum": [
        "draft",
        "open",
        "paid",
        "uncollectible",
        "void"
      ],
      "type": "string"
    },
    "customer": {
      "type": "string"
    },
    "subscription": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_create_invoice

Create a new invoice.

Args:

customer: Customer ID (required)
subscription: Subscription ID (optional)
description: Invoice description
metadata: Custom metadata
auto_advance: Auto-finalize after 1 hour
collection_method: "charge_automatically" or "send_invoice"
days_until_due: Days until due (for send_invoice)

Returns: The created invoice.

{
  "type": "object",
  "required": [
    "customer"
  ],
  "properties": {
    "customer": {
      "type": "string",
      "description": "Customer ID"
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "auto_advance": {
      "type": "boolean"
    },
    "subscription": {
      "type": "string"
    },
    "days_until_due": {
      "type": "integer"
    },
    "collection_method": {
      "enum": [
        "charge_automatically",
        "send_invoice"
      ],
      "type": "string"
    }
  }
}

stripe_update_invoice

Update an invoice (draft only for some fields).

Args:

invoice_id: The Invoice ID
description: New description
metadata: New metadata
auto_advance: Whether to auto-advance

Returns: The updated invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "metadata": {
      "type": "object"
    },
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    },
    "description": {
      "type": "string"
    },
    "auto_advance": {
      "type": "boolean"
    }
  }
}

stripe_delete_invoice

Delete a draft invoice.

Args:

invoice_id: The Invoice ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    }
  }
}

stripe_finalize_invoice

Finalize a draft invoice (makes it ready to pay).

Args:

invoice_id: The Invoice ID

Returns: The finalized invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    }
  }
}

stripe_pay_invoice

Pay an open invoice.

Args:

invoice_id: The Invoice ID
payment_method: Payment method ID (optional)

Returns: The paid invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    },
    "payment_method": {
      "type": "string",
      "description": "Payment method ID"
    }
  }
}

stripe_send_invoice

Send an invoice to the customer (for manual collection).

Args:

invoice_id: The Invoice ID

Returns: The sent invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    }
  }
}

stripe_void_invoice

Void an open invoice.

Args:

invoice_id: The Invoice ID

Returns: The voided invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    }
  }
}

stripe_mark_invoice_uncollectible

Mark an invoice as uncollectible.

Args:

invoice_id: The Invoice ID

Returns: The uncollectible invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID"
    }
  }
}

stripe_search_invoices

Search invoices using Stripe search syntax.

Query examples:

status:"paid"
customer:"cus_xxx"
total>1000

Args:

query: Search query
limit: Maximum results

Returns: List of matching invoices.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_invoice_items

List invoice items with pagination.

Args:

limit: Number of results
starting_after: Invoice item ID for pagination
customer: Filter by customer ID
invoice: Filter by invoice ID

Returns: List of invoice items

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "invoice": {
      "type": "string"
    },
    "customer": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_invoice_item

Get an invoice item by ID.

Args:

invoice_item_id: The Invoice Item ID (ii_...)

Returns: The invoice item details.

{
  "type": "object",
  "required": [
    "invoice_item_id"
  ],
  "properties": {
    "invoice_item_id": {
      "type": "string",
      "description": "Invoice Item ID"
    }
  }
}

stripe_create_invoice_item

Create an invoice item (line item for a future invoice).

Args:

customer: Customer ID (required)
amount: Amount in cents
currency: Currency code
description: Description
invoice: Add to specific invoice
price: Use a price ID instead of amount
quantity: Quantity (for price-based)
metadata: Custom metadata

Returns: The created invoice item.

{
  "type": "object",
  "required": [
    "customer"
  ],
  "properties": {
    "price": {
      "type": "string",
      "description": "Price ID"
    },
    "amount": {
      "type": "integer",
      "description": "Amount in cents"
    },
    "invoice": {
      "type": "string",
      "description": "Invoice ID"
    },
    "currency": {
      "type": "string"
    },
    "customer": {
      "type": "string",
      "description": "Customer ID"
    },
    "metadata": {
      "type": "object"
    },
    "quantity": {
      "type": "integer"
    },
    "description": {
      "type": "string"
    }
  }
}

stripe_update_invoice_item

Update an invoice item.

Args:

invoice_item_id: The Invoice Item ID
amount: New amount
description: New description
metadata: New metadata
quantity: New quantity

Returns: The updated invoice item.

{
  "type": "object",
  "required": [
    "invoice_item_id"
  ],
  "properties": {
    "amount": {
      "type": "integer"
    },
    "metadata": {
      "type": "object"
    },
    "quantity": {
      "type": "integer"
    },
    "description": {
      "type": "string"
    },
    "invoice_item_id": {
      "type": "string",
      "description": "Invoice Item ID"
    }
  }
}

stripe_delete_invoice_item

Delete an invoice item.

Args:

invoice_item_id: The Invoice Item ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "invoice_item_id"
  ],
  "properties": {
    "invoice_item_id": {
      "type": "string",
      "description": "Invoice Item ID"
    }
  }
}

stripe_get_payment_intent

Get a payment intent by ID.

Args:

payment_intent_id: The PaymentIntent ID (pi_...)

Returns: The payment intent details.

{
  "type": "object",
  "required": [
    "payment_intent_id"
  ],
  "properties": {
    "payment_intent_id": {
      "type": "string",
      "description": "PaymentIntent ID"
    }
  }
}

stripe_create_payment_intent

Create a new payment intent.

Args:

amount: Amount in smallest currency unit (e.g., cents for USD)
currency: Three-letter ISO currency code (e.g., "usd")
customer: Customer ID to attach payment to
description: Description for the payment
metadata: Custom key-value data
payment_method_types: Allowed payment methods (default: ["card"])
capture_method: "automatic" or "manual"

Returns: The created PaymentIntent with client_secret for frontend.

{
  "type": "object",
  "required": [
    "amount",
    "currency"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount in cents"
    },
    "currency": {
      "type": "string",
      "description": "Currency code (e.g., usd)"
    },
    "customer": {
      "type": "string",
      "description": "Customer ID"
    },
    "metadata": {
      "type": "object",
      "description": "Custom metadata"
    },
    "description": {
      "type": "string",
      "description": "Payment description"
    },
    "capture_method": {
      "enum": [
        "automatic",
        "manual"
      ],
      "type": "string",
      "description": "Capture method"
    },
    "payment_method_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Allowed payment methods"
    }
  }
}

stripe_update_payment_intent

Update a payment intent.

Args:

payment_intent_id: The PaymentIntent ID
amount: New amount
currency: New currency
customer: New customer ID
description: New description
metadata: New metadata

Returns: The updated PaymentIntent.

{
  "type": "object",
  "required": [
    "payment_intent_id"
  ],
  "properties": {
    "amount": {
      "type": "integer"
    },
    "currency": {
      "type": "string"
    },
    "customer": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "payment_intent_id": {
      "type": "string",
      "description": "PaymentIntent ID"
    }
  }
}

stripe_confirm_payment_intent

Confirm a payment intent to proceed with payment.

Args:

payment_intent_id: The PaymentIntent ID

Returns: The confirmed PaymentIntent.

{
  "type": "object",
  "required": [
    "payment_intent_id"
  ],
  "properties": {
    "payment_intent_id": {
      "type": "string",
      "description": "PaymentIntent ID"
    }
  }
}

stripe_capture_payment_intent

Capture a PaymentIntent that was created with capture_method=manual.

Args:

payment_intent_id: The PaymentIntent ID
amount_to_capture: Amount to capture (optional, defaults to full amount)

Returns: The captured PaymentIntent.

{
  "type": "object",
  "required": [
    "payment_intent_id"
  ],
  "properties": {
    "amount_to_capture": {
      "type": "integer"
    },
    "payment_intent_id": {
      "type": "string",
      "description": "PaymentIntent ID"
    }
  }
}

stripe_cancel_payment_intent

Cancel a payment intent.

Args:

payment_intent_id: The PaymentIntent ID

Returns: The canceled PaymentIntent.

{
  "type": "object",
  "required": [
    "payment_intent_id"
  ],
  "properties": {
    "payment_intent_id": {
      "type": "string",
      "description": "PaymentIntent ID"
    }
  }
}

stripe_search_payment_intents

Search payment intents using Stripe search syntax.

Query examples:

status:"succeeded"
customer:"cus_xxx"
amount>1000

Args:

query: Search query
limit: Maximum results

Returns: List of matching payment intents.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_setup_intents

List setup intents for saving payment methods.

Args:

limit: Number of results (1-100)
starting_after: SetupIntent ID for pagination
customer: Filter by customer ID

Returns: List of setup intents

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "customer": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_setup_intent

Get a setup intent by ID.

Args:

setup_intent_id: The SetupIntent ID (seti_...)

Returns: The setup intent details.

{
  "type": "object",
  "required": [
    "setup_intent_id"
  ],
  "properties": {
    "setup_intent_id": {
      "type": "string",
      "description": "SetupIntent ID"
    }
  }
}

stripe_create_setup_intent

Create a setup intent for saving a payment method.

Args:

customer: Customer ID to save payment method for
description: Description
metadata: Custom metadata
payment_method_types: Allowed payment method types
usage: "off_session" or "on_session"

Returns: The created SetupIntent with client_secret.

{
  "type": "object",
  "properties": {
    "usage": {
      "enum": [
        "off_session",
        "on_session"
      ],
      "type": "string"
    },
    "customer": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    },
    "payment_method_types": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

stripe_cancel_setup_intent

Cancel a setup intent.

Args:

setup_intent_id: The SetupIntent ID

Returns: The canceled SetupIntent.

{
  "type": "object",
  "required": [
    "setup_intent_id"
  ],
  "properties": {
    "setup_intent_id": {
      "type": "string",
      "description": "SetupIntent ID"
    }
  }
}

stripe_list_charges

List charges with pagination.

Args:

limit: Number of results (1-100)
starting_after: Charge ID for pagination
customer: Filter by customer ID
payment_intent: Filter by PaymentIntent ID

Returns: List of charges

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "customer": {
      "type": "string"
    },
    "payment_intent": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_charge

Get a charge by ID.

Args:

charge_id: The Charge ID (ch_...)

Returns: The charge details.

{
  "type": "object",
  "required": [
    "charge_id"
  ],
  "properties": {
    "charge_id": {
      "type": "string",
      "description": "Charge ID"
    }
  }
}

stripe_update_charge

Update a charge's description or metadata.

Args:

charge_id: The Charge ID
description: New description
metadata: New metadata

Returns: The updated charge.

{
  "type": "object",
  "required": [
    "charge_id"
  ],
  "properties": {
    "metadata": {
      "type": "object"
    },
    "charge_id": {
      "type": "string",
      "description": "Charge ID"
    },
    "description": {
      "type": "string"
    }
  }
}

stripe_search_charges

Search charges using Stripe search syntax.

Query examples:

status:"succeeded"
customer:"cus_xxx"
amount>1000

Args:

query: Search query
limit: Maximum results

Returns: List of matching charges.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_refunds

List refunds with pagination.

Args:

limit: Number of results (1-100)
starting_after: Refund ID for pagination
charge: Filter by charge ID
payment_intent: Filter by PaymentIntent ID

Returns: List of refunds

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "charge": {
      "type": "string"
    },
    "payment_intent": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_refund

Get a refund by ID.

Args:

refund_id: The Refund ID (re_...)

Returns: The refund details.

{
  "type": "object",
  "required": [
    "refund_id"
  ],
  "properties": {
    "refund_id": {
      "type": "string",
      "description": "Refund ID"
    }
  }
}

stripe_create_refund

Create a refund for a charge or payment intent.

Args:

charge: Charge ID to refund (or use payment_intent)
payment_intent: PaymentIntent ID to refund (or use charge)
amount: Amount to refund in cents (optional, full amount if not specified)
reason: Reason for refund (duplicate, fraudulent, requested_by_customer)
metadata: Custom metadata

Returns: The created refund.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount in cents"
    },
    "charge": {
      "type": "string",
      "description": "Charge ID"
    },
    "reason": {
      "enum": [
        "duplicate",
        "fraudulent",
        "requested_by_customer"
      ],
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "payment_intent": {
      "type": "string",
      "description": "PaymentIntent ID"
    }
  }
}

stripe_cancel_refund

Cancel a refund (only possible if not yet processed).

Args:

refund_id: The Refund ID

Returns: The canceled refund.

{
  "type": "object",
  "required": [
    "refund_id"
  ],
  "properties": {
    "refund_id": {
      "type": "string",
      "description": "Refund ID"
    }
  }
}

stripe_list_payment_methods

List payment methods for a customer.

Args:

customer: Customer ID (required)
type: Payment method type (e.g., "card")
limit: Number of results

Returns: List of payment methods

{
  "type": "object",
  "required": [
    "customer"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Payment method type"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "customer": {
      "type": "string",
      "description": "Customer ID"
    }
  }
}

stripe_get_payment_method

Get a payment method by ID.

Args:

payment_method_id: The PaymentMethod ID (pm_...)

Returns: The payment method details.

{
  "type": "object",
  "required": [
    "payment_method_id"
  ],
  "properties": {
    "payment_method_id": {
      "type": "string",
      "description": "PaymentMethod ID"
    }
  }
}

stripe_attach_payment_method

Attach a payment method to a customer.

Args:

payment_method_id: The PaymentMethod ID
customer: Customer ID to attach to

Returns: The attached payment method.

{
  "type": "object",
  "required": [
    "payment_method_id",
    "customer"
  ],
  "properties": {
    "customer": {
      "type": "string",
      "description": "Customer ID"
    },
    "payment_method_id": {
      "type": "string",
      "description": "PaymentMethod ID"
    }
  }
}

stripe_detach_payment_method

Detach a payment method from its customer.

Args:

payment_method_id: The PaymentMethod ID

Returns: The detached payment method.

{
  "type": "object",
  "required": [
    "payment_method_id"
  ],
  "properties": {
    "payment_method_id": {
      "type": "string",
      "description": "PaymentMethod ID"
    }
  }
}

stripe_list_disputes

List disputes with pagination.

Args:

limit: Number of results (1-100)
starting_after: Dispute ID for pagination
charge: Filter by charge ID
payment_intent: Filter by PaymentIntent ID

Returns: List of disputes

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "charge": {
      "type": "string"
    },
    "payment_intent": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_dispute

Get a dispute by ID.

Args:

dispute_id: The Dispute ID (dp_...)

Returns: The dispute details.

{
  "type": "object",
  "required": [
    "dispute_id"
  ],
  "properties": {
    "dispute_id": {
      "type": "string",
      "description": "Dispute ID"
    }
  }
}

stripe_close_dispute

Close a dispute (accept the dispute and stop contesting).

Args:

dispute_id: The Dispute ID

Returns: The closed dispute.

{
  "type": "object",
  "required": [
    "dispute_id"
  ],
  "properties": {
    "dispute_id": {
      "type": "string",
      "description": "Dispute ID"
    }
  }
}

stripe_list_products

List products with pagination.

Args:

limit: Number of results (1-100)
starting_after: Product ID for pagination
active: Filter by active status

Returns: List of products

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "active": {
      "type": "boolean"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_product

Get a product by ID.

Args:

product_id: The Product ID (prod_...)

Returns: The product details.

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID"
    }
  }
}

stripe_create_product

Create a new product.

Args:

name: Product name (required)
description: Product description
active: Whether the product is active
metadata: Custom metadata
images: Array of image URLs
url: Product URL

Returns: The created product.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "Product name"
    },
    "active": {
      "type": "boolean"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "metadata": {
      "type": "object"
    },
    "description": {
      "type": "string"
    }
  }
}

stripe_update_product

Update a product.

Args:

product_id: The Product ID
name: New name
description: New description
active: New active status
metadata: New metadata
images: New image URLs

Returns: The updated product.

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "metadata": {
      "type": "object"
    },
    "product_id": {
      "type": "string",
      "description": "Product ID"
    },
    "description": {
      "type": "string"
    }
  }
}

stripe_search_products

Search products using Stripe search syntax.

Query examples:

name~"Premium"
active:"true"
metadata["type"]:"subscription"

Args:

query: Search query
limit: Maximum results

Returns: List of matching products.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_prices

List prices with pagination.

Args:

limit: Number of results (1-100)
starting_after: Price ID for pagination
active: Filter by active status
product: Filter by product ID
type: Filter by type ("one_time" or "recurring")

Returns: List of prices

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "one_time",
        "recurring"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "active": {
      "type": "boolean"
    },
    "product": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_price

Get a price by ID.

Args:

price_id: The Price ID (price_...)

Returns: The price details.

{
  "type": "object",
  "required": [
    "price_id"
  ],
  "properties": {
    "price_id": {
      "type": "string",
      "description": "Price ID"
    }
  }
}

stripe_create_price

Create a new price for a product.

Args:

product: Product ID (required)
currency: Three-letter currency code (required)
unit_amount: Price in cents
recurring: For subscriptions - { interval: "day"|"week"|"month"|"year", interval_count?: number }
active: Whether the price is active
nickname: A brief description
metadata: Custom metadata

Returns: The created price.

{
  "type": "object",
  "required": [
    "product",
    "currency"
  ],
  "properties": {
    "active": {
      "type": "boolean"
    },
    "product": {
      "type": "string",
      "description": "Product ID"
    },
    "currency": {
      "type": "string",
      "description": "Currency code"
    },
    "metadata": {
      "type": "object"
    },
    "nickname": {
      "type": "string"
    },
    "unit_amount": {
      "type": "integer",
      "description": "Amount in cents"
    }
  }
}

stripe_update_price

Update a price (only active, nickname, and metadata can be updated).

Args:

price_id: The Price ID
active: New active status
nickname: New nickname
metadata: New metadata

Returns: The updated price.

{
  "type": "object",
  "required": [
    "price_id"
  ],
  "properties": {
    "active": {
      "type": "boolean"
    },
    "metadata": {
      "type": "object"
    },
    "nickname": {
      "type": "string"
    },
    "price_id": {
      "type": "string",
      "description": "Price ID"
    }
  }
}

stripe_search_prices

Search prices using Stripe search syntax.

Query examples:

product:"prod_xxx"
active:"true"
type:"recurring"

Args:

query: Search query
limit: Maximum results

Returns: List of matching prices.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_subscriptions

List subscriptions with pagination.

Args:

limit: Number of results (1-100)
starting_after: Subscription ID for pagination
customer: Filter by customer ID
price: Filter by price ID
status: Filter by status (active, past_due, canceled, etc.)

Returns: List of subscriptions

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "price": {
      "type": "string"
    },
    "customer": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_subscription

Get a subscription by ID.

Args:

subscription_id: The Subscription ID (sub_...)

Returns: The subscription details.

{
  "type": "object",
  "required": [
    "subscription_id"
  ],
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

stripe_create_subscription

Create a new subscription.

Args:

customer: Customer ID (required)
items: Array of { price: "price_id", quantity?: number } (required)
default_payment_method: Payment method ID
collection_method: "charge_automatically" or "send_invoice"
days_until_due: Days until invoice is due (for send_invoice)
metadata: Custom metadata
trial_period_days: Number of trial days
cancel_at_period_end: Whether to cancel at period end

Returns: The created subscription.

{
  "type": "object",
  "required": [
    "customer"
  ],
  "properties": {
    "customer": {
      "type": "string",
      "description": "Customer ID"
    },
    "metadata": {
      "type": "object"
    },
    "days_until_due": {
      "type": "integer"
    },
    "collection_method": {
      "enum": [
        "charge_automatically",
        "send_invoice"
      ],
      "type": "string"
    },
    "trial_period_days": {
      "type": "integer"
    },
    "cancel_at_period_end": {
      "type": "boolean"
    },
    "default_payment_method": {
      "type": "string"
    }
  }
}

stripe_update_subscription

Update a subscription.

Args:

subscription_id: The Subscription ID
items: New items array (to change plans/quantities)
default_payment_method: New payment method
metadata: New metadata
cancel_at_period_end: Whether to cancel at period end
proration_behavior: "create_prorations", "none", or "always_invoice"

Returns: The updated subscription.

{
  "type": "object",
  "properties": {
    "metadata": {
      "type": "object"
    },
    "subscription_id": {
      "type": "string",
      "description": "Subscription ID"
    },
    "proration_behavior": {
      "enum": [
        "create_prorations",
        "none",
        "always_invoice"
      ],
      "type": "string"
    },
    "cancel_at_period_end": {
      "type": "boolean"
    },
    "default_payment_method": {
      "type": "string"
    }
  }
}

stripe_cancel_subscription

Cancel a subscription.

Args:

subscription_id: The Subscription ID
invoice_now: Generate final invoice immediately
prorate: Prorate the cancellation

Returns: The canceled subscription.

{
  "type": "object",
  "required": [
    "subscription_id"
  ],
  "properties": {
    "prorate": {
      "type": "boolean"
    },
    "invoice_now": {
      "type": "boolean"
    },
    "subscription_id": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

stripe_resume_subscription

Resume a paused subscription.

Args:

subscription_id: The Subscription ID

Returns: The resumed subscription.

{
  "type": "object",
  "required": [
    "subscription_id"
  ],
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

stripe_search_subscriptions

Search subscriptions using Stripe search syntax.

Query examples:

status:"active"
customer:"cus_xxx"
metadata["plan"]:"premium"

Args:

query: Search query
limit: Maximum results

Returns: List of matching subscriptions.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

stripe_list_subscription_items

List items in a subscription.

Args:

subscription: Subscription ID (required)
limit: Number of results

Returns: List of subscription items

{
  "type": "object",
  "required": [
    "subscription"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "subscription": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

stripe_get_subscription_item

Get a subscription item by ID.

Args:

subscription_item_id: The Subscription Item ID (si_...)

Returns: The subscription item details.

{
  "type": "object",
  "required": [
    "subscription_item_id"
  ],
  "properties": {
    "subscription_item_id": {
      "type": "string",
      "description": "Subscription Item ID"
    }
  }
}

stripe_create_subscription_item

Add an item to an existing subscription.

Args:

subscription: Subscription ID (required)
price: Price ID (required)
quantity: Quantity
metadata: Custom metadata

Returns: The created subscription item.

{
  "type": "object",
  "required": [
    "subscription",
    "price"
  ],
  "properties": {
    "price": {
      "type": "string",
      "description": "Price ID"
    },
    "metadata": {
      "type": "object"
    },
    "quantity": {
      "type": "integer"
    },
    "subscription": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

stripe_update_subscription_item

Update a subscription item.

Args:

subscription_item_id: The Subscription Item ID
price: New price ID
quantity: New quantity
metadata: New metadata

Returns: The updated subscription item.

{
  "type": "object",
  "required": [
    "subscription_item_id"
  ],
  "properties": {
    "price": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "quantity": {
      "type": "integer"
    },
    "subscription_item_id": {
      "type": "string",
      "description": "Subscription Item ID"
    }
  }
}

stripe_delete_subscription_item

Remove an item from a subscription.

Args:

subscription_item_id: The Subscription Item ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "subscription_item_id"
  ],
  "properties": {
    "subscription_item_id": {
      "type": "string",
      "description": "Subscription Item ID"
    }
  }
}

stripe_list_plans

List plans (legacy, use prices instead).

Args:

limit: Number of results
starting_after: Plan ID for pagination
active: Filter by active status
product: Filter by product ID

Returns: List of plans

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "active": {
      "type": "boolean"
    },
    "product": {
      "type": "string"
    },
    "starting_after": {
      "type": "string"
    }
  }
}

stripe_get_plan

Get a plan by ID (legacy, use prices instead).

Args:

plan_id: The Plan ID

Returns: The plan details.

{
  "type": "object",
  "required": [
    "plan_id"
  ],
  "properties": {
    "plan_id": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}