Stripe MCP Server

A Model Context Protocol (MCP) server that provides AI assistants (Claude, Cursor, etc.) with a comprehensive interface to the Stripe API.

Overview

stripe-mcp allows your AI assistant to directly interact with your Stripe data. It enables powerful natural language queries like:

• "How many active subscriptions do we have?"
• "Why did the last payment for cus_123 fail?"
• "Summarize our payouts from the last 30 days."
• "What is our current available balance in USD?"

Features

• Modular Architecture: Built with clean layered design for high maintainability.
• Type-Safe: Fully implemented in TypeScript with Zod schema validation.
• Comprehensive Coverage: Full access to Customers, Payments, Subscriptions, Invoices, Products, Checkout, Reporting, and Tax.
• LLM-Optimized: Responses are automatically transformed to reduce token usage.

Installation

Using npx (Recommended)

No installation required. Run directly:

npx -y @vineethnkrishnan/stripe-mcp

Global Install

npm install -g @vineethnkrishnan/stripe-mcp
stripe-mcp

From Source

git clone https://github.com/vineethkrishnan/mcp-pool.git
cd mcp-pool
npm install
npm run build

Configuration

Add to your MCP client configuration file:

| Platform | Config file path | |----------|-----------------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

Using npx (Recommended)

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@vineethnkrishnan/stripe-mcp"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Local Build

{
  "mcpServers": {
    "stripe": {
      "command": "node",
      "args": ["/absolute/path/to/stripe-mcp/build/index.js"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | STRIPE_SECRET_KEY | Yes | - | Stripe secret API key (starts with sk_test_ or sk_live_). |

Getting Your API Key

1. Log in to the Stripe Dashboard
2. Go to Developers > API keys
3. Copy your Secret key (starts with sk_test_ for test mode or sk_live_ for production)

Use a test mode key (sk_test_...) while getting started. Switch to live mode when ready.

Response Optimization

All responses are automatically optimized for LLM context windows:

• Internal keys stripped: object, livemode, request, pending_webhooks, api_version, and lastResponse are removed from Stripe responses.
• Timestamps converted: Unix timestamps (e.g., created, current_period_end) are converted to human-readable ISO 8601 strings.

This reduces token usage and improves readability for AI assistants.

Documentation

For a full list of available tools, detailed examples, and architectural details, visit the documentation site or refer to the local documentation guide.

Uninstallation

# If installed globally
npm uninstall -g @vineethnkrishnan/stripe-mcp

Testing

npm test

License

This project is licensed under the MIT License.