Skip to content

Release Notes - v0.1.0

Choose a tag to compare

View all tags
@hideokamoto hideokamoto released this 09 Jun 23:23
· 23 commits to main since this release
v0.1.0
91e0f28

🎉 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.

Assets 2
Loading