Stripe Testing MCP Server

A Model Context Protocol (MCP) server that streamlines testing and debugging of Stripe integrations. Provides comprehensive testing tools for time-based tests, customer management, product management, and more.

npx stripe-test-mcp

Key Features

Time Simulation Tools

Create and advance Stripe test clocks to efficiently execute time-based test scenarios

Customer Management

Bulk create/delete test customers with test clock associations for efficient test environment setup

Product Management

Archive and delete test products to maintain a clean test environment

Subscription Testing

Test billing cycles and renewals with configurable subscription creation and proration behavior

Security

Only accepts test API keys and rejects production API keys to ensure security

Easy Setup

No installation required, start immediately with npx command. Auto-updates ensure you always use the latest version

How to Use

Get Stripe API Key

Generate an API key in your Stripe test environment or sandbox environment

sk_test_your_test_key_here: Secret API Key

or

rk_test_your_test_key_here: Restricted API Key

Configure MCP Client

Add configuration to your MCP client such as Claude Desktop or Cursor

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

Start Testing

Call tools from your MCP client to execute Stripe test workflows

Available Tools

Test Clock Tools

• create_stripe_test_clock - Create a new Stripe test clock
• advance_stripe_test_clock - Advance an existing test clock to a new time

Customer Management Tools

• create_stripe_test_customers - Create multiple test customers
• delete_stripe_test_customers - Delete test customers by ID

Product Management Tools

• archive_stripe_test_products - Archive test products (active: false)
• delete_stripe_test_products - Completely delete test products

Subscription Tools

• create_stripe_test_subscription - Create test subscriptions for customers

Use Case: Time-based Subscription Testing

1. Create a test clock

Use create_stripe_test_clockwith frozen_time: 1704067200 (January 1, 2024)

2. Create customers associated with the test clock

Use create_stripe_test_customerswith the test_clock ID to create customers

3. Create subscriptions for customers

Use create_stripe_test_subscriptionwith customer ID and subscription items

4. Advance time to trigger billing

Use advance_stripe_test_clockto advance time by the billing cycle period

Get Started Now

Streamline your Stripe test workflows without any installation

npx stripe-test-mcp