# Release v0.2.0

🎉 What's New

Enhanced Payment Method Support

• Subscription Payment Methods: Added payment_method_id parameter to create_stripe_test_subscription tool, enabling you to set default payment methods when creating subscriptions
• Customer Payment Methods: Improved create_stripe_test_customers tool to automatically set both payment_method and invoice_settings when a payment_method_id is provided
• Better integration of payment methods with Stripe's test environment for more realistic testing scenarios

SDK Updates & Modernization

• MCP SDK v1.22.0: Updated to the latest version of @modelcontextprotocol/sdk
• New MCP SDK API: Migrated to the new MCP SDK API with improved tool annotations
• Enhanced type safety and better developer experience

Infrastructure Improvements

• Automated Releases: Set up np for streamlined npm package releases
• Test Script: Added test script to ensure release process runs smoothly

🔧 Technical Details

This release includes significant improvements to payment method handling, making it easier to test subscription workflows with payment methods in Stripe's test environment. The migration to the new MCP SDK API ensures better compatibility with the latest MCP standards and improved tool metadata.

📦 Installation

Update to the latest version:

npm install -g stripe-test-mcp@latest

Or use directly with npx (no installation needed):

npx stripe-test-mcp

🙏 Thanks

Thank you for using Stripe Testing Tools MCP Server! If you encounter any issues or have feature requests, please open an issue on GitHub.

Enhanced Payment Method Support

Enhanced Payment Method Support

• Payment Method for Subscription Creation: Added payment_method_id parameter to the create_stripe_test_subscription tool
• Improved Customer Creation Payment Settings: Enhanced the create_stripe_test_customers tool to automatically set invoice_settings when a payment method is specified

🚀 Improvements

• You can now specify a default payment method when creating subscriptions
• Payment method settings during customer creation are now more reliable (setting both payment_method and invoice_settings.default_payment_method)
• Smoother integration of payment methods in Stripe test environment

🔧 Technical Changes

create_stripe_test_subscription Tool

• New parameter: payment_method_id (optional)
• Added functionality to set default_payment_method during subscription creation

create_stripe_test_customers Tool

• When payment_method_id is specified, both of the following are now set:
  • payment_method: Customer's payment method
  • invoice_settings.default_payment_method: Default payment method for invoices

Fix command error

Update bin command name to the appropriate name.

Release Notes - v0.1.0

🎉 First Release

We're excited to announce the first release of stripe-test-mcp, a Model Context Protocol (MCP) server that provides comprehensive testing and debugging tools for Stripe integrations.

🚀 Features

Time Simulation Tools

• Test Clock Management: Create and manage Stripe test clocks for time-based testing scenarios
• Time Advancement: Advance test clocks to simulate the passage of time and trigger time-based events
• Subscription Testing: Test billing cycles and subscription renewals by controlling time flow

Customer Management

• Bulk Customer Creation: Create multiple test customers with customizable properties
• Test Clock Association: Link customers to test clocks for time-controlled testing (up to 3 customers per clock)
• Customer Cleanup: Delete test customers to maintain clean test environments

Product Management

• Product Archiving: Archive test products by ID or URL to disable them without deletion
• Product Deletion: Permanently delete test products to clean up test data

Subscription Testing

• Test Subscription Creation: Create subscriptions with configurable proration behavior
• Time-based Billing Testing: Test subscription billing cycles using test clocks

🛠️ Available Tools

This release includes the following MCP tools:

• create_stripe_test_clock - Create new test clocks for time simulation
• advance_stripe_test_clock - Advance existing test clocks to new times
• create_stripe_test_customers - Create one or more test customers
• delete_stripe_test_customers - Delete test customers by their IDs
• archive_stripe_test_products - Archive test products (set active: false)
• delete_stripe_test_products - Permanently delete test products
• create_stripe_test_subscription - Create test subscriptions for customers

📦 Installation

No installation required! Use directly with npx:

npx stripe-test-mcp

⚙️ Configuration

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "stripe-test-mcp": {
      "command": "npx",
      "args": ["stripe-test-mcp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_test_key_here"
      }
    }
  }
}

🔒 Security Features

• Test-only Mode: Only accepts Stripe test API keys for security
• Live Key Protection: Automatically rejects live API keys to prevent accidental charges
• Safe Testing Environment: All operations performed in Stripe's test mode

🎯 Use Cases

Perfect for:

• Testing time-sensitive Stripe workflows
• Simulating subscription billing cycles
• Creating and managing test data
• Debugging Stripe integrations
• Automated testing scenarios

📋 Requirements

• Node.js and npm
• Stripe test API key
• MCP-compatible client (Claude Desktop, etc.)

🐛 Known Limitations

• Maximum 3 customers per test clock (Stripe limitation)
• Test mode only (by design for security)

🤝 Contributing

This is an open-source project. Contributions are welcome! See the repository for development setup instructions.

---

Full Changelog: Initial release

For detailed usage instructions and examples, see the README.md.