@stripe/mcp/README.md

A command line tool for setting up Stripe MCP server

# Stripe Model Context Protocol

The Stripe [Model Context Protocol](https://modelcontextprotocol.com/) server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.

## Setup

To run the Stripe MCP server using npx, use the following command:

```bash
# To set up all available tools
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

# To set up specific tools
npx -y @stripe/mcp --tools=customers.create,customers.read,products.create --api-key=YOUR_STRIPE_SECRET_KEY

# To configure a Stripe connected account
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY --stripe-account=CONNECTED_ACCOUNT_ID
```

Make sure to replace `YOUR_STRIPE_SECRET_KEY` with your actual Stripe secret key. Alternatively, you could set the STRIPE_SECRET_KEY in your environment variables.

### Usage with Claude Desktop

Add the following to your `claude_desktop_config.json`. See [here](https://modelcontextprotocol.io/quickstart/user) for more details.

```
{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
          "-y",
          "@stripe/mcp",
          "--tools=all",
          "--api-key=STRIPE_SECRET_KEY"
      ]
    }
  }
}
```

## Available tools

| Tool                   | Description                     |
| ---------------------- | ------------------------------- |
| `customers.create`     | Create a new customer           |
| `customers.read`       | Read customer information       |
| `products.create`      | Create a new product            |
| `products.read`        | Read product information        |
| `prices.create`        | Create a new price              |
| `prices.read`          | Read price information          |
| `paymentLinks.create`  | Create a new payment link       |
| `invoices.create`      | Create a new invoice            |
| `invoices.update`      | Update an existing invoice      |
| `invoiceItems.create`  | Create a new invoice item       |
| `balance.read`         | Retrieve balance information    |
| `refunds.create`       | Create a new refund             |
| `paymentIntents.read`  | Read payment intent information |
| `subscriptions.read`   | Read subscription information   |
| `subscriptions.update` | Update subscription information |
| `documentation.read`   | Search Stripe documentation     |

## Debugging the Server

To debug your server, you can use the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector).

First build the server

```
npm run build
```

Run the following command in your terminal:

```bash
# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js --tools=all --api-key=YOUR_STRIPE_SECRET_KEY
```

### Instructions

1. Replace `YOUR_STRIPE_SECRET_KEY` with your actual Stripe API secret key.
2. Run the command to start the MCP Inspector.
3. Open the MCP Inspector UI in your browser and click Connect to start the MCP server.
4. You can see the list of tools you selected and test each tool individually.