Skip to content
cccskills
FreePublished on GitHub

stripe-test-data-lifecycle

Set up, verify, and clean up Stripe test data end to end. Use when creating test customers, products, or subscriptions and you want a repeatable setup-then-teardown workflow, or when you need to remove leftover test customers and products with delete_stripe_test_customers, archive_stripe_test_products, and delete_stripe_test_products.

The English summary is being prepared. Showing the original description.

Works withStripe
See how to install

Files included (1)

  • SKILL.md3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Stripe Test Data Lifecycle

A round-trip workflow for Stripe test data: set up, verify, then clean up so the test account stays tidy. Test mode only (live keys are rejected).

1. Setup

  • Customers: create_stripe_test_customers
    • number (default 1), and optional name, email, description, payment_method_id, test_clock.
    • Every customer created here is tagged with metadata.generator = stripe-testing-tools-mcp. The MCP server has no tool to list or search customers by metadata, so record the ids returned at creation for later cleanup. The tag is still useful for finding leftovers in the Stripe Dashboard or Stripe CLI.
    • If attaching a test_clock, keep number at most 3 (see stripe-test-clock-constraints).
  • Subscriptions: create_stripe_test_subscription
    • customer, items ([{ price, quantity }]), optional proration_behavior, payment_method_id.
  • Products/prices: create these with your normal Stripe tooling or Dashboard; this MCP only archives/deletes products, it does not create them.

2. Verify

  • Run your scenario (for time-based billing, follow stripe-billing-cycle-test).
  • Confirm results (invoices, subscription status, charges) via the Stripe Dashboard in test mode or the Stripe API. The MCP does not expose list/read tools for these objects.

3. Cleanup (recommended order)

Tear down dependents before their dependencies to avoid leftover references:

  1. Delete customers: delete_stripe_test_customers
    • customer_ids: array of ids to delete. You must use the ids collected at creation — the MCP cannot search customers by generator metadata. To recover lost ids, look them up in the Stripe Dashboard or CLI.
    • Deleting a customer immediately cancels its associated subscriptions (Stripe: Delete a customer), so do this before touching products.
  2. Archive products: archive_stripe_test_products
    • product_ids and/or urls. Archiving sets active: false and is non-destructive (recoverable). Prefer this when a product may still be referenced or you want a soft cleanup.
  3. Delete products (optional, permanent): delete_stripe_test_products
    • product_ids and/or urls. Permanent and irreversible. Stripe only lets you delete a product with no active prices/usage; if deletion fails, archive instead. Confirm the exact deletability rules against the Stripe docs when in doubt.

Notes

  • Both product tools accept either explicit product_ids or urls (the URL form looks products up by their url field).
  • Test clocks themselves are not deleted by these tools; remove unused clocks from the Stripe Dashboard if needed.
  • Always double-check you are operating in test mode before any delete.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Verify Stripe subscription billing cycles using a test clock. Use when you need to simulate time passing to trigger subscription renewals, recurring invoices, or to confirm that the next billing date generates the expected charge in Stripe test mode.

The English summary is being prepared. Showing the original description.

hideokamoto/stripe-testing-mcp-tools9Updated Jul 29, 2026

Stripe CLI の `stripe fixtures` コマンドで実行可能な fixture JSON を、対話的に整理しながら生成・検証する。test_clock を使った時間進行、サブスクのライフサイクル、失敗カードでの payment_intent 失敗、Connect 配下の Destination charge、bulk 件数のテスト顧客作成など、複数ステップの API リクエスト連鎖を扱う。「Stripe の fixture を書いて」「fixtures.json を作って」「このシナリオを fixture 化」「テストデータを大量に作りたい」「サブスクの月次失敗をテストしたい」「stripe trigger と fixture どっち使う」のような依頼で起動する。"fixture" という単語が無くても、複数ステップの Stripe テストデータ準備、 test clock を使った時間進行、 bulk なテスト顧客作成、 失敗パターンの再現といった意図が見えたら起動する。単発 API 呼び出しが目的なら起動せずに `stripe trigger` か API 1コールを案内する。

The English summary is being prepared. Showing the original description.

hideokamoto/stripe-testing-mcp-tools9Updated Jul 29, 2026

Reference for Stripe test clock constraints and pitfalls. Use when planning or debugging test-clock workflows, when an advance or customer-attach step fails, or to check rules before building a time-simulation scenario with create_stripe_test_clock, advance_stripe_test_clock, and create_stripe_test_customers.

The English summary is being prepared. Showing the original description.

hideokamoto/stripe-testing-mcp-tools9Updated Jul 29, 2026

See all skills by hideokamoto

Report a problem with this skill