Skip to main content

Stripe

Connects to the Stripe API for billing and payments. An agent can list customers, charges, invoices, and products, and create payment links.

Add to an agent node's tools array with _node_type: "tool-stripe". See Connector Reference — How connectors are used.

Authentication

FieldRequiredDescription
secret_keyYesStripe secret API key, sent as Authorization: Bearer <secret_key>. Typically a stored secret.
{
"name": "stripe",
"_node_type": "tool-stripe",
"secret_key": "{{ secret.STRIPE_SECRET_KEY }}"
}

Tools

stripe_list_customers

List customers from Stripe.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax customers to return (default 10)
emailstringNoFilter by email address

Returns: A list of - **<name>** <<email>> id: <id> created: <unix timestamp> lines, or "No customers found.".

stripe_get_customer

Get full details of a Stripe customer.

Parameters

ParameterTypeRequiredDescription
customer_idstringYesStripe customer ID (cus_...)

Returns: A text block with the customer's name, email, phone, account balance and currency, and description.

stripe_list_charges

List recent charges from Stripe.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax charges to return (default 10)
customer_idstringNoFilter by customer ID

Returns: A list of - <amount> <CURRENCY> | <status> | <description> id: <id> lines (amount converted from the smallest currency unit), or "No charges found.".

stripe_list_invoices

List invoices from Stripe.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax invoices to return (default 10)
customer_idstringNoFilter by customer ID
statusstringNoFilter by status: draft, open, paid, uncollectible, void

Returns: A list of - <amount due> <CURRENCY> | <status> | due: <unix timestamp> id: <id> lines, or "No invoices found.".

stripe_list_products

List products from Stripe catalog.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax products to return (default 10)
activebooleanNoFilter to active products only

Returns: A list of - **<name>** id: <id>\n <description> entries, or "No products found.".

Create a Stripe payment link for a product/price.

Parameters

ParameterTypeRequiredDescription
price_idstringYesStripe Price ID (price_...)
quantitynumberNoQuantity (default 1)

Returns: A confirmation message with the payment link ID and its URL.

Next