{
  "markdown": "[![npm version](https://img.shields.io/npm/v/@devtechtricks/stripe-mcp.svg)](https://www.npmjs.com/package/@devtechtricks/stripe-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@devtechtricks/stripe-mcp.svg)](https://www.npmjs.com/package/@devtechtricks/stripe-mcp)\n[![license](https://img.shields.io/npm/l/@devtechtricks/stripe-mcp.svg)](https://github.com/robinafaruqia/stripe-mcp/blob/main/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/robinafaruqia/stripe-mcp.svg?style=social)](https://github.com/robinafaruqia/stripe-mcp)\n# stripe-mcp\n\nA **read-only MCP server** for querying **Stripe** — customers, payments, subscriptions, invoices, and refunds.\n\nUse it with **any AI or client that supports MCP** (Model Context Protocol)—Cursor, Claude Desktop, Claude Code, Windsurf, or other MCP hosts.\n\n## Features\n\n- **Read-only by design** — no charge, refund, update, or delete tools\n- **Test keys only** — refuses to start with `sk_live_` / `rk_live_`\n- **Single file** — just `index.js`, no build step\n- **Works with any MCP client** — Cursor, Claude, Windsurf, and others\n\n## MCP Configuration\n\n### Cursor — one-click install\n\n[![Add MCP server to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=stripe-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBkZXZ0ZWNodHJpY2tzL3N0cmlwZS1tY3AiXSwiZW52Ijp7IlNUUklQRV9TRUNSRVRfS0VZIjoiWU9VUl9TVFJJUEVfVEVTVF9LRVkifX0=)\n\nAfter install, replace `YOUR_STRIPE_TEST_KEY` with a Stripe **test** secret (`sk_test_...` or `rk_test_...`) from the [Stripe Dashboard](https://dashboard.stripe.com/test/apikeys). A restricted key with only read scopes is preferred.\n\n### Using npx (recommended)\n\nAdd to your MCP client config (e.g. Cursor: `~/.cursor/mcp.json` or Settings → MCP; Claude: `claude_desktop_config.json`; etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"stripe-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@devtechtricks/stripe-mcp\"],\n      \"env\": {\n        \"STRIPE_SECRET_KEY\": \"sk_test_...\"\n      }\n    }\n  }\n}\n```\n\nClaude Code:\n\n```bash\nclaude mcp add stripe-mcp --env STRIPE_SECRET_KEY=sk_test_... -- npx -y @devtechtricks/stripe-mcp\n```\n\n### From source (development)\n\n```bash\ngit clone https://github.com/robinafaruqia/stripe-mcp.git\ncd stripe-mcp\nnpm install\ncp .env.example .env   # then put your sk_test_ / rk_test_ key in .env\n```\n\nThen in your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"stripe-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/stripe-mcp/index.js\"]\n    }\n  }\n}\n```\n\n`index.js` loads `.env` from the package directory when `STRIPE_SECRET_KEY` is not already set. npm installs do not include `.env` — MCP clients should pass the key in `env`.\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_customers` | List recent customers. Optional: `limit`, `email`. |\n| `get_customer` | Get a customer by ID. Required: `customer_id`. |\n| `list_payments` | List recent payment intents. Optional: `limit`, `customer_id`. |\n| `get_payment` | Get a payment intent by ID. Required: `payment_intent_id`. |\n| `list_subscriptions` | List subscriptions. Optional: `limit`, `customer_id`, `status`. |\n| `get_subscription` | Get a subscription by ID. Required: `subscription_id`. |\n| `list_invoices` | List invoices. Optional: `limit`, `customer_id`, `status`. |\n| `list_refunds` | List refunds. Optional: `limit`, `payment_intent_id`. |\n\n## Example\n\n```\n1. list_customers({ limit: 5 })\n2. get_customer({ customer_id: \"cus_ABC123\" })\n3. list_subscriptions({ customer_id: \"cus_ABC123\" })\n4. list_payments({ limit: 10 })\n```\n\n## License\n\nMIT\n",
  "bytes": 3605,
  "sha": "32cbcb6ae6189fcfc63aec9ca480698971ee14e3220cc9c2836f78ee674fea39",
  "repo_slug": "robinafaruqia/stripe-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_robinafaruqia_stripe_mcp_a84233bf/readme"
}