# Stripe

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Empower your agents to interact with the Stripe API."
  author="Arcade"
  authType="API Key"
  versions={["0.1.0"]}
/>

<Badges repo="arcadeai/arcade-stripe" />

The Arcade Stripe MCP Sever lets you interact with the Stripe API. Use these tools to build intelligent agents and applications that process payments, create invoices, and more.

## Available Tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    ["Stripe.CreateCustomer", "This tool will create a customer in Stripe."],
    [
      "Stripe.ListCustomers",
      "This tool will fetch a list of Customers from Stripe.",
    ],
    ["Stripe.CreateProduct", "This tool will create a product in Stripe."],
    [
      "Stripe.ListProducts",
      "This tool will fetch a list of Products from Stripe.",
    ],
    [
      "Stripe.CreatePrice",
      "This tool will create a price in Stripe. If a product has not already been",
    ],
    ["Stripe.ListPrices", "This tool will fetch a list of Prices from Stripe."],
    [
      "Stripe.CreatePaymentLink",
      "This tool will create a payment link in Stripe.",
    ],
    ["Stripe.ListInvoices", "This tool will list invoices in Stripe."],
    ["Stripe.CreateInvoice", "This tool will create an invoice in Stripe."],
    [
      "Stripe.CreateInvoiceItem",
      "This tool will create an invoice item in Stripe.",
    ],
    ["Stripe.FinalizeInvoice", "This tool will finalize an invoice in Stripe."],
    [
      "Stripe.RetrieveBalance",
      "This tool will retrieve the balance from Stripe. It takes no input.",
    ],
    [
      "Stripe.CreateRefund",
      "This tool will refund a payment intent in Stripe.",
    ],
    [
      "Stripe.ListPaymentIntents",
      "This tool will list payment intents in Stripe.",
    ],
    [
      "Stripe.CreateBillingPortalSession",
      "This tool will create a billing portal session.",
    ],
  ]}
/>

<Callout>
  If you need an action that's not listed here, please [contact
  us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

## Stripe.CreateCustomer

Create a customer in Stripe.

**Parameters**

- **`name`** _(string, required)_: The name of the customer.
- **`email`** _(string, optional)_: The email address of the customer.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_customer_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_customer_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.ListCustomers

Fetch a list of customers from Stripe.

**Parameters**

- **`limit`** _(int, optional, defaults to 10)_: A limit on the number of objects to be returned. Limit can range between 1 and 100.
- **`email`** _(string, optional)_: A case-sensitive filter on the list based on the customer's email field.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/list_customers_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/list_customers_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreateProduct

Create a product in Stripe.

**Parameters**

- **`name`** _(string, required)_: The name of the product.
- **`description`** _(string, optional)_: The description of the product.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_product_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_product_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.ListProducts

Fetch a list of products from Stripe.

**Parameters**

- **`limit`** _(int, optional, defaults to 10)_: A limit on the number of products returned. Limit can range between 1 and 100, and defaults to 10.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/list_products_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/list_products_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreatePrice

Create a price in Stripe.

**Parameters**

- **`product`** _(string, required)_: The ID of the product to create the price for.
- **`unit_amount`** _(int, required)_: The unit amount of the price in cents.
- **`currency`** _(string, required)_: The currency of the price.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_price_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_price_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.ListPrices

Fetch a list of prices from Stripe.

**Parameters**

- **`product`** _(string, optional)_: The ID of the product to list prices for.
- **`limit`** _(int, optional, defaults to 10)_: A limit on the number of objects to be returned. Limit can range between 1 and 100, and defaults to 10.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/list_prices_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/list_prices_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreatePaymentLink

Create a payment link in Stripe.

**Parameters**

- **`price`** _(string, required)_: The ID of the price to create the payment link for.
- **`quantity`** _(int, required)_: The quantity of the product to include.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_payment_link_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_payment_link_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.ListInvoices

List invoices in Stripe.

**Parameters**

- **`customer`** _(string, optional)_: The ID of the customer to list invoices for.
- **`limit`** _(int, optional, defaults to 10)_: A limit on the number of invoices returned. Limit can range between 1 and 100, and defaults to 10.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/list_invoices_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/list_invoices_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreateInvoice

Create an invoice in Stripe.

**Parameters**

- **`customer`** _(string, required)_: The ID of the customer to create the invoice for.
- **`days_until_due`** _(int, optional)_: The number of days until the invoice is due.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_invoice_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_invoice_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreateInvoiceItem

Create an invoice item in Stripe.

**Parameters**

- **`customer`** _(string, required)_: The ID of the customer to create the invoice item for.
- **`price`** _(string, required)_: The ID of the price for the item.
- **`invoice`** _(string, required)_: The ID of the invoice to create the item for.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_invoice_item_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_invoice_item_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.FinalizeInvoice

Finalize an invoice in Stripe.

**Parameters**

- **`invoice`** _(string, required)_: The ID of the invoice to finalize.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/finalize_invoice_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/finalize_invoice_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.RetrieveBalance

Retrieve the balance from Stripe. This tool takes no inputs.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/retrieve_balance_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/retrieve_balance_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreateRefund

Refund a payment intent in Stripe.

**Parameters**

- **`payment_intent`** _(string, required)_: The ID of the PaymentIntent to refund.
- **`amount`** _(int, optional)_: The refund amount to refund in cents.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_refund_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_refund_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.ListPaymentIntents

List payment intents in Stripe.

**Parameters**

- **`customer`** _(string, optional)_: The ID of the customer to list payment intents for.
- **`limit`** _(int, optional)_: A limit on the number of payment intents returned. Limit can range between 1 and 100, and defaults to 10.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/list_payment_intents_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/list_payment_intents_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Stripe.CreateBillingPortalSession

Create a billing portal session in Stripe.

**Parameters**

- **`customer`** _(string, required)_: The ID of the customer to create the billing portal session for.
- **`return_url`** _(string, optional)_: The default URL to return to afterwards.

<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/stripe/create_billing_portal_session_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/stripe/create_billing_portal_session_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Auth

The Arcade Stripe MCP Sever uses the [Stripe Agent Toolkit](https://github.com/stripe/agent-MCP Sever) to interact with the Stripe API.

- **Required Secret:**
  - `STRIPE_SECRET_KEY`: Your Stripe API key.

<ToolFooter pipPackageName="arcade_stripe" />