> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe clone

> Test billing agents against a stateful Stripe clone of customers, products, prices, payments, invoices, subscriptions, and disputes with real error shapes.

Clone ID: `stripe`

Covers customers, products, prices, payments, invoices, subscriptions, and disputes. Two modes: **strict** (default) exposes only the tools in the real Stripe MCP server. **Extended** (`--strict=false`) adds tools like `create_payment_intent` and `confirm_payment_intent`. Errors match Stripe's error format for covered tools.

## Start here

| Question     | Answer                                                                                                                                          |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Best for     | Billing agents that create customers, adjust invoices, review subscriptions, issue refunds, or investigate disputes.                            |
| Connect with | Route mode for `api.stripe.com`, direct REST base URLs from `archal clone start stripe`, or MCP tools.                                          |
| Known limits | Documentation search, integration recommender, and feedback tools are stubbed. Strict mode intentionally follows the real Stripe MCP tool list. |
| Seeds        | Common seeds: `small-business`, `subscription-heavy`, `checkout-flow`, `empty`. See [Seeds](/guides/seeds) for usage.                           |

## Available tools

### Core tools (strict mode)

#### Customers

| Tool              | Description                                   |
| ----------------- | --------------------------------------------- |
| `create_customer` | Create a new customer in Stripe               |
| `list_customers`  | List customers, optionally filtering by email |

#### Products & Prices

| Tool             | Description                                  |
| ---------------- | -------------------------------------------- |
| `create_product` | Create a new product                         |
| `list_products`  | List products                                |
| `create_price`   | Create a new price for a product             |
| `list_prices`    | List prices, optionally filtering by product |

#### Payment Intents

| Tool                   | Description                                            |
| ---------------------- | ------------------------------------------------------ |
| `list_payment_intents` | List payment intents, optionally filtering by customer |

#### Refunds

| Tool            | Description                                                    |
| --------------- | -------------------------------------------------------------- |
| `create_refund` | Create a refund for a charge or payment intent                 |
| `list_refunds`  | List refunds, optionally filtering by charge or payment intent |

#### Invoices

| Tool                  | Description                                               |
| --------------------- | --------------------------------------------------------- |
| `create_invoice`      | Create a new draft invoice for a customer                 |
| `list_invoices`       | List invoices, optionally filtering by customer or status |
| `create_invoice_item` | Create an invoice item and attach it to an invoice        |
| `finalize_invoice`    | Finalize a draft invoice so it can be paid                |

#### Subscriptions

| Tool                  | Description                                                    |
| --------------------- | -------------------------------------------------------------- |
| `list_subscriptions`  | List subscriptions, optionally filtering by customer or status |
| `update_subscription` | Update an existing subscription                                |
| `cancel_subscription` | Cancel a subscription immediately or at period end             |

#### Other

| Tool                             | Description                                       |
| -------------------------------- | ------------------------------------------------- |
| `retrieve_balance`               | Retrieve the current account balance              |
| `create_coupon`                  | Create a coupon for discounts                     |
| `list_coupons`                   | List coupons                                      |
| `create_payment_link`            | Create a payment link for a price                 |
| `list_disputes`                  | List disputes on charges                          |
| `update_dispute`                 | Update a dispute with evidence                    |
| `search_stripe_resources`        | Search for resources using custom query syntax    |
| `fetch_stripe_resources`         | Retrieve Stripe object details by ID              |
| `search_stripe_documentation`    | Search Stripe documentation                       |
| `get_stripe_account_info`        | Get account info for the logged-in Stripe account |
| `stripe_integration_recommender` | Interactive Q\&A for integration planning         |
| `send_stripe_mcp_feedback`       | Submit feedback about Stripe's MCP tools          |

### Extended tools (strict=false only)

| Tool                     | Description                                                  |
| ------------------------ | ------------------------------------------------------------ |
| `retrieve_customer`      | Retrieve a specific customer by ID                           |
| `create_payment_intent`  | Create a new payment intent                                  |
| `confirm_payment_intent` | Confirm a payment intent to process payment                  |
| `capture_payment_intent` | Capture a previously authorized payment intent               |
| `cancel_payment_intent`  | Cancel a payment intent                                      |
| `handle_next_action`     | Handle the next action for a payment intent requiring action |
| `retrieve_refund`        | Retrieve a specific refund by ID                             |
| `pay_invoice`            | Pay an open invoice                                          |
| `void_invoice`           | Void an open invoice                                         |
| `create_subscription`    | Create a new subscription for a customer                     |
| `list_payment_links`     | List payment links                                           |

## Notes

* `--rate-limit=N` triggers rate limit errors after N requests.
* Create operations support idempotency keys.
* `stripe_integration_recommender` and `search_stripe_documentation` return stubs (no real API calls).