💳 MCP Stripe Finance

A production-grade MCP server for Stripe financial operations. Gives AI assistants (Claude, Cursor, VS Code, Claude Code, any MCP client) direct access to Stripe APIs — payments, customers, subscriptions, invoices, products, prices, refunds, and balance checks.

Why This Exists

The MCP ecosystem has 325+ finance/commerce servers but no high-quality, comprehensive Stripe MCP server existed before this one. The existing mcp-stripe (Python) has only 44 stars and limited functionality. This is a TypeScript-native implementation with 17 tools covering the full Stripe lifecycle.

Compared to Alternatives

Prerequisites

• Node.js 18+

• A Stripe API key (get one at https://dashboard.stripe.com/apikeys)

  • Use sk_test_... for development/testing

  • Use sk_live_... for production

Quick Start

1. Install & Run

# Clone and install
git clone <your-repo-url>
cd mcp-stripe-finance
npm install
npm run build

# Set your Stripe key
export STRIPE_API_KEY=sk_test_your_key_here

# Start the server (stdio mode — integrates with MCP clients)
node dist/index.js

2. Install from npm (once published)

npm install -g mcp-stripe-finance
# or use directly with npx
npx mcp-stripe-finance

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "stripe-finance": {
      "command": "node",
      "args": ["/path/to/mcp-stripe-finance/dist/index.js"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Cursor

In Cursor settings → MCP Servers → Add:

• Name: Stripe Finance

• Type: command

• Command: node /path/to/mcp-stripe-finance/dist/index.js

• Environment Variables: STRIPE_API_KEY=sk_test_your_key_here

VS Code (via Continue.dev or similar)

{
  "mcpServers": {
    "stripe-finance": {
      "command": "node",
      "args": ["/path/to/mcp-stripe-finance/dist/index.js"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Smithery.ai (Remote Hosting)

Configure Smithery to run the Docker image or point at your hosted instance with STRIPE_API_KEY environment.

Available Tools

💰 Payments

👥 Customers

💳 Subscriptions

📄 Invoices

📦 Products & Pricing

📊 Account

Example Queries (What AI Can Do)

"Create a new customer named Jane Doe with email jane@example.com" → stripe_create_customer({name: "Jane Doe", email: "jane@example.com"})

"Charge Jane $25 for a monthly subscription" → stripe_create_customer, then stripe_create_product, stripe_create_price with recurring, stripe_create_subscription

"What's my current Stripe balance?" → stripe_retrieve_balance()

"Refund the last payment from customer cus_xyz" → stripe_list_payments, then stripe_create_refund

"Create a $49.99 monthly subscription for customer cus_abc with a 14-day trial" → stripe_create_subscription({customer_id: "cus_abc", items: [{price: "price_xyz"}], trial_period_days: 14})

Development

# Watch mode
npm run dev

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Inspect with MCP Inspector
npm run inspect

# Build
npm run build

Testing with the MCP Inspector

# Terminal 1: Set your key and start the server
export STRIPE_API_KEY=sk_test_...
npm run inspect

The MCP Inspector provides a browser UI to test each tool interactively.

Security

• Never commit your Stripe API key. Use environment variables or .env files.

• Test with sk_test_ keys in development.

• The server provides read-only balance information and write access to your Stripe account. Be careful which AI clients have access.

• All tools require the STRIPE_API_KEY environment variable to be set at startup.

License

MIT