# Stripe MCP Server

A Model Context Protocol server for the Stripe API. Provides 21 tools for managing customers, charges, payments, subscriptions, products, prices, invoices, refunds, transfers, and webhooks.

## Features

- **Balance** — Check available and pending balances
- **Customers** — List, create, retrieve, update customers
- **Charges** — List and retrieve charges with filters
- **Payment Intents** — Create and list payment intents
- **Products** — List and create products
- **Prices** — List and create one-time and recurring prices
- **Subscriptions** — List, create, and cancel subscriptions
- **Invoices** — List invoices with status filters
- **Refunds** — Full or partial refunds with reason tracking
- **Transfers** — List Connect platform transfers
- **Webhooks** — List and create webhook endpoints

## Installation

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "stripe-mcp-server"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}
```

### Cursor / VS Code

Add to your MCP configuration:

```json
{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "stripe-mcp-server"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}
```

### Manual

```bash
npm install -g stripe-mcp-server
export STRIPE_API_KEY=sk_test_your_key_here
stripe-mcp-server
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `STRIPE_API_KEY` | Yes | Your Stripe secret key (sk_test_... or sk_live_...) |

## Usage

### Get account balance

```json
{ "tool": "get_balance", "arguments": {} }
```

### Create a customer

```json
{
  "tool": "create_customer",
  "arguments": {
    "email": "customer@example.com",
    "name": "Jane Doe"
  }
}
```

### Create a payment intent

```json
{
  "tool": "create_payment_intent",
  "arguments": {
    "amount": 2000,
    "currency": "usd",
    "customer": "cus_abc123",
    "description": "Order #1234"
  }
}
```

### Create a subscription

```json
{
  "tool": "create_subscription",
  "arguments": {
    "customer": "cus_abc123",
    "price": "price_xyz789"
  }
}
```

## API Coverage

| Resource | Tools |
|----------|-------|
| Balance | `get_balance` |
| Customers | `list_customers`, `create_customer`, `retrieve_customer`, `update_customer` |
| Charges | `list_charges`, `retrieve_charge` |
| Payment Intents | `create_payment_intent`, `list_payment_intents` |
| Products | `list_products`, `create_product` |
| Prices | `list_prices`, `create_price` |
| Subscriptions | `list_subscriptions`, `create_subscription`, `cancel_subscription` |
| Invoices | `list_invoices` |
| Refunds | `create_refund` |
| Transfers | `list_transfers` |
| Webhooks | `list_webhook_endpoints`, `create_webhook_endpoint` |

## Development

```bash
git clone https://github.com/friendlygeorge/stripe-mcp-server.git
cd stripe-mcp-server
npm install
npm run build
npm start
```

## License

MIT