Interact with Stripe for customer management, subscriptions, payments, invoices, and more.

Stripe guMCP Server

Only return customers that were created during the given date interval using Unix timestamps

Return customers created after this timestamp (exclusive)

Return customers created after or equal to this timestamp (inclusive)

Return customers created before this timestamp (exclusive)

Return customers created before or equal to this timestamp (inclusive)

A case-sensitive filter on the list based on the customer's email field. The value must be a string

A cursor for use in pagination. ending_before is an object ID that defines your place in the list

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10

A cursor for use in pagination. starting_after is an object ID that defines your place in the list

Provides a list of customers that are associated with the specified test clock. The response will not include customers with test clocks if this parameter is not set

list_customers

Array of JSON strings containing customer data with customer details, billing information, and metadata

retrieve_balance

Array containing a single JSON string with complete account balance information including available, pending, and reserved funds

The collection method of the subscriptions to retrieve

Only return subscriptions that were created during the given date interval using Unix timestamps

Return subscriptions created after this timestamp

Return subscriptions created after or equal to this timestamp

Return subscriptions created before this timestamp

Return subscriptions created before or equal to this timestamp

The ID of the customer whose subscriptions will be retrieved

The email of the customer whose subscriptions will be retrieved (alternative to customer)

Filter for subscriptions that contain this recurring price ID

The status of the subscriptions to retrieve. Pass 'canceled' to return all canceled subscriptions, 'all' to return subscriptions of all statuses

list_subscriptions

Array of JSON strings containing subscription data with subscription details, billing details, and metadata

Update subscription with specified parameters

Automatic tax settings for this subscription

Whether Stripe automatically computes tax on this subscription

A timestamp at which the subscription should cancel. If set to a date before the current period ends, this will cause a proration if prorations have been enabled

Indicate whether this subscription should cancel at the end of the current period. Defaults to false

Either charge_automatically or send_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle

Number of days a customer has to pay invoices generated by this subscription. Valid only for subscriptions where collection_method is set to send_invoice

ID of the default payment method for the subscription. It must belong to the customer associated with the subscription

The subscription's description, meant to be displayable to the customer

A list of up to 20 subscription items, each with an attached price or product

Either price or product_id must be provided for each item (unless deleting)

Use allow_incomplete to transition the subscription to status=past_due if a payment is required but cannot be paid

Determines how to handle prorations when the billing cycle changes. Default is create_prorations

The ID of the subscription to update (required)

Unix timestamp representing the end of the trial period the customer will get before being charged for the first time

update_subscription

Array containing a single JSON string with updated subscription information including billing details, status, and metadata

list_payment_intents

Array of JSON strings containing payment intent data with payment details, status, and metadata

Only return charges that were created during the given date interval using Unix timestamps

Return charges created after this timestamp (exclusive)

Return charges created after or equal to this timestamp (inclusive)

Return charges created before this timestamp (exclusive)

Return charges created before or equal to this timestamp (inclusive)

Only return charges for the customer specified by this customer ID

Only return charges for the customer specified by this email (alternative to customer)

Only return charges that were created by the PaymentIntent specified by this PaymentIntent ID

Only return charges for this transfer group (Connect only, limited to 100)

list_charges

Array of JSON strings containing charge data with payment details, status, and metadata. Returns empty array if no charges found

Create customer with complete details as needed

Two-letter country code (ISO 3166-1 alpha-2)

Address line 1 (e.g., street, PO Box, or company name)

Address line 2 (e.g., apartment, suite, unit, or building)

An integer amount in cents that represents the customer's current balance. A negative amount represents a credit that decreases the amount due on an invoice; a positive amount increases the amount due on an invoice.

If you provide a coupon code, the customer will have a discount applied on all recurring charges.

An arbitrary string that you can attach to a customer object. It is displayed alongside the customer in the dashboard.

Customer's email address. It's displayed alongside the customer in your dashboard and can be useful for searching and tracking. This may be up to 512 characters.

The prefix for the customer used to generate unique invoice numbers. Must be 3–12 uppercase letters or numbers.

Default invoice settings for this customer

ID of a payment method that's attached to the customer, to be used as the customer's default payment method for subscriptions and invoices

The customer's full name or business name.

The ID of the PaymentMethod to attach to the customer.

Customer's preferred languages, ordered by preference

The ID of a promotion code to apply to the customer. The customer will have a discount applied on all recurring payments.

The customer's shipping information. Appears on invoices emailed to this customer.

When using payment sources created via the Token or Sources APIs, passing source will create a new source object, make it the new customer default source, and delete the old customer default if one exists. Use 'tok_visa' for testing.

The customer's tax exemption. One of none, exempt, or reverse.

create_customer

Array containing a single JSON string with complete customer information including billing details and metadata

List invoices, Either customer or customer_email is required

The collection method of the invoice to retrieve. Either charge_automatically or send_invoice

Only return invoices that were created during the given date interval using Unix timestamps

Return invoices created after this timestamp (exclusive)

Return invoices created after or equal to this timestamp (inclusive)

Return invoices created before this timestamp (exclusive)

Return invoices created before or equal to this timestamp (inclusive)

Only return invoices for the customer specified by this customer ID

Only return invoices for the customer specified by this email (alternative to customer)

The status of the invoice, one of draft, Failed, open, paid, uncollectible, or void

Only return invoices for the subscription specified by this subscription ID

list_invoices

Array of JSON strings containing invoice data with invoice details, line items, customer information, and payment status

The email of the customer to retrieve (alternative to customer_id)

retrieve_customer

list_products

Array of JSON strings containing product data with product details, pricing information, and metadata

Details about why this subscription was cancelled

Additional information about why this subscription was cancelled

The customer's reason for cancelling their subscription

Will generate a final invoice that invoices for any un-invoiced metered usage and new/pending proration invoice items

Will generate a proration invoice item that credits remaining unused time. Only valid when used with invoice_now=true

The ID of the subscription to cancel (required)

cancel_subscription

Array containing a single JSON string with cancelled subscription information including cancellation details and final status

retrieve_subscription

Array containing a single JSON string with complete subscription information including billing details, status, and metadata

Create subscription with all required parameters

Either charge_automatically or send_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer

Three-letter ISO currency code, in lowercase. Must be a supported currency

The identifier of the customer to subscribe (required)

The email of the customer to subscribe (alternative to customer)

A list of up to 20 subscription items, each with an attached price or product (required)

Either price or product_id must be provided for each item

Use allow_incomplete to create Subscriptions with status=incomplete if the first invoice can't be paid

Determines how to handle prorations resulting from the billing_cycle_anchor. Default is create_prorations

Integer representing the number of trial period days before the customer is charged for the first time

create_subscription

Array containing a single JSON string with complete subscription information including billing details, items, and initial status

Update customer with all relevant details

An integer amount in cents that represents the customer's current balance. A negative amount represents a credit; a positive amount increases the amount due on invoices.

Customer email to identify customer (alternative to customer_id)

Provide the ID of a payment source already attached to this customer to make it this customer's default payment source.

Customer's email address. This may be up to 512 characters.

When using payment sources created via the Token or Sources APIs, passing source will create a new source object and make it the new customer default source.

update_customer

Array containing a single JSON string with updated customer information including billing details and metadata

Create coupon with discount configuration

A positive integer representing the amount to subtract from an invoice total in cents (required if percent_off is not passed)

Object specifying what this coupon applies to

Array of product IDs this coupon applies to

Three-letter ISO code for the currency of the amount_off parameter (required if amount_off is passed)

Coupons defined in each available currency option (only supported if amount_off is passed)

Specifies how long the discount will be in effect. 'forever' applies to all charges, 'once' applies to first charge only, 'repeating' applies for duration_in_months

Number of months the coupon applies (required only if duration is 'repeating')

Unique string identifier for this coupon. If not specified, Stripe will generate a random code

Maximum number of times this coupon can be redeemed across all customers

Name of the coupon displayed to customers on invoices or receipts

A positive float larger than 0 and smaller or equal to 100, representing the discount percentage (required if amount_off is not passed)

Unix timestamp specifying the last time the coupon can be redeemed

create_coupon

Array containing a single JSON string with complete coupon information including discount details and metadata

The name of the coupon to retrieve (alternative to coupon_id)

retrieve_coupon

Filter coupons based on creation date using Unix timestamps

Return coupons created after this timestamp

Return coupons created after or on this timestamp

Return coupons created before this timestamp

Return coupons created before or on this timestamp

Cursor for pagination - coupon ID to end before

Maximum number of coupons to return (1-100, default is 10)

Cursor for pagination - coupon ID to start after

list_coupons

Array of JSON strings containing coupon data with discount details and metadata

delete_coupon

Array containing a single JSON string confirming coupon deletion

Maximum number of customers to return (1-100, default is 10)

A cursor for pagination across multiple pages of results. Use the next_page value returned in a previous response to request subsequent results.

The search query string using Stripe's Search Query Language. Examples: 'name:"John Doe"', 'email:"test@example.com"', 'metadata["key"]:"value"'

search_customers

Array of JSON strings containing customer data matching the search criteria. Returns empty array if no customers found

Maximum number of invoices to return (1-100, default is 10)

A cursor for pagination across multiple pages of results. Use the next_page value returned in a previous response to request subsequent results

The search query string using Stripe's Search Query Language. Examples: 'status:"paid"', 'total>1000', 'customer:"cus_123"', 'created>1640995200'

search_invoices

Array of JSON strings containing invoice data matching the search criteria. Returns empty array if no invoices found

Stripe guMCP Server

Tools

List Customers

Retrieve Balance

List Subscriptions

Update Subscription

List Payment Intents

List Charges

Create Customer

List Invoices

Retrieve Customer

List Products

Cancel Subscription

Retrieve Subscription

Create Subscription

Update Customer

Create Coupon

Retrieve Coupon

List Coupons

Delete Coupon

Search Customers

Search Invoices

Installation Steps

Create a Gumloop Account

Generate Your Server URL