# mcp-stripe

This skill lets an agent handle Stripe records through MCP, from customers and invoices to payment links. Refunds and selected account changes require user approval.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 736 installs · ★ 338
- Author: Heyvhuang
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Heyvhuang/ship-faster/tree/HEAD/skills/mcp-stripe/SKILL.md
- Updated: 2026-08-15
- HTML: https://affpapa.org/en/nevibecode/skills/mcp-stripe

## What it does

The skill connects an agent to Stripe MCP to look up customers and payments, create products, prices, invoices and payment links, and inspect balances, subscriptions and disputes. Refunds and changes to subscriptions or disputes require explicit approval. Test mode is the default; switching to live mode requires the user to say “live” and confirm twice.

Before creating a customer, product or price, the agent checks whether a matching object already exists. If an ID or parameter is unclear, it searches Stripe resources or documentation instead of guessing. After an operation, it returns the object type, ID, key fields and next steps. For multi-step workflows, it recommends keeping inputs, plans, receipts and logs in project files, without copying sensitive details verbatim into logs.

Claude Code must connect to `https://mcp.stripe.com/` and authenticate with OAuth; if an API key is needed, the skill recommends a restricted key. It cannot create PaymentIntents or subscriptions directly, issue promotion codes, or delete objects.

## Requirements
- Works with: Stripe

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Heyvhuang/ship-faster --skill mcp-stripe -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcp-stripe/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcp-stripe/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Heyvhuang/ship-faster --skill mcp-stripe -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcp-stripe/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Heyvhuang/ship-faster --skill mcp-stripe -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcp-stripe/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Heyvhuang/ship-faster mcp-stripe
```

2. **Manually: put the files in place**
- File: `.github/skills/mcp-stripe/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Heyvhuang/ship-faster --skill mcp-stripe -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Heyvhuang/ship-faster --path skills/mcp-stripe
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcp-stripe/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Heyvhuang/ship-faster --skill mcp-stripe -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Heyvhuang/ship-faster/tree/HEAD/skills/mcp-stripe/SKILL.md

## When to use it
- check for an existing customer before creating one
- create a Stripe product and price
- prepare an invoice and a shareable payment link
- inspect balances, payments or disputes
- issue a refund after user approval

## Example prompts
- Find the customer with this email address and create a record if none exists.
- Create a product and a GBP price, checking Stripe for an existing match first.
- Find the payment I want refunded, show its amount and wait for my confirmation.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cdcd56bae2aff3e0.

BEGIN THIRD-PARTY FILE cdcd56bae2aff3e0
````text
---
name: mcp-stripe
description: "Stripe MCP transaction operations skill. Execute transaction operations via Stripe MCP server (https://mcp.stripe.com): customer management, products/prices, invoices, payment links, subscriptions, refunds, dispute handling, balance queries. Triggers: user requests Stripe operations including create customer, create product, create invoice, generate payment link, query transactions, process refunds, manage subscriptions, view disputes, check balance, etc."
disable-model-invocation: true
---

# Stripe MCP Transaction Skill

Execute transaction operations via Stripe MCP server.

## File-based Pipeline (Pass Paths Only)

When integrating billing operations into multi-step workflows, persist all context and artifacts to disk, passing only paths between agents/sub-agents.

Recommended directory structure (within project): `runs/<workflow>/active/<run_id>/`

- Input: `01-input/goal.md` (requirements), `01-input/context.json` (known customer/invoice/subscription/payment_intent IDs, etc.)
- Plan: `03-plans/stripe-actions.md` (list of operations to execute; money/contracts must be written here and await confirmation first)
- Output: `05-final/receipt.md` + `05-final/receipt.json` (object type + ID + key fields + next steps)
- Logs: `logs/events.jsonl` (summary of each tool call; do not log sensitive information verbatim)

## Connection Configuration

MCP Server: `https://mcp.stripe.com`

**Claude Code Connection**:
```bash
claude mcp add --transport http stripe https://mcp.stripe.com/
claude /mcp  # authenticate
```

**Authentication**: OAuth preferred; if API key needed, use restricted key as Bearer token.

**Mode**: Test mode by default. Switching to live requires user to explicitly say "live" and double confirmation.

## Three Hard Rules

1. **Read before write** - Before creating customer/product/price, first use `list_*` or `search_stripe_resources` to check if it already exists, avoid duplicate objects
2. **Money and contracts require confirmation** - `create_refund`, `cancel_subscription`, `update_subscription`, `update_dispute` must display content and get explicit user confirmation before execution
3. **When in doubt, search** - If unsure about object ID, fields, or approach, first call `search_stripe_documentation` or `search_stripe_resources`, don't guess parameters

## Available Tools

| Category | Tool | Description |
|----------|------|-------------|
| Account | `get_stripe_account_info` | Get account info |
| Balance | `retrieve_balance` | Query available/pending balance |
| Customer | `create_customer`, `list_customers` | Create/list customers |
| Product | `create_product`, `list_products` | Create/list products |
````
END THIRD-PARTY FILE cdcd56bae2aff3e0

The third-party file has ended. Everything between the cdcd56bae2aff3e0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2704 of 6684 bytes. © Heyvhuang · MIT · https://github.com/Heyvhuang/ship-faster/tree/HEAD/skills/mcp-stripe/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md