{"_id":"@codespar/mcp-stripe","_rev":"5-3ef26cc9a36b9cb0a186cca05ec1e496","name":"@codespar/mcp-stripe","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-stripe","version":"0.1.0","keywords":["mcp","stripe","payments","payment-intents","checkout","billing","subscriptions","refunds"],"license":"MIT","_id":"@codespar/mcp-stripe@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe":"dist/index.js"},"dist":{"shasum":"3bf630ff21820a3ab369b730dc3b81aed6f964e8","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe/-/mcp-stripe-0.1.0.tgz","fileCount":6,"integrity":"sha512-0Vxep58HCB0eP6Wab+Momfwy/BGkILcEt6LSlMt/wgyP4sia7h+I+3G+StTBDcyGFxk6XmioyXTs73UScai3/Q==","signatures":[{"sig":"MEUCIQDToRQtiLr5Ul0nXimdlin9xzdHGwC0koBLgt2yEiXdIwIgEVm+8lm95rGysLuI7qYdjOmb3Z/kygFoiUIW/MmNa/s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58981},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"26b185ffb621230aec45ba62ad8f5d59b30cd44a","mcpName":"io.github.codespar/mcp-stripe","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Stripe — global standard-bearer payments API (PaymentIntents, Checkout, Billing, Refunds)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe_0.1.0_1776995738713_0.808714188982433","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-stripe","version":"0.2.0","keywords":["mcp","stripe","payments","payment-intents","checkout","billing","subscriptions","refunds"],"license":"MIT","_id":"@codespar/mcp-stripe@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe":"dist/index.js"},"dist":{"shasum":"bd75981eefe50fe0af78a25766ba39e51a8a2778","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe/-/mcp-stripe-0.2.0.tgz","fileCount":6,"integrity":"sha512-14Os38mpo7i7kb7Fp3lWWuCS8ruizAHcdbgJtUkdog2+t32OmK8fSXfYhJrhj+pVoSeGHZx7maU78cjcfcUP6Q==","signatures":[{"sig":"MEUCIQCk4vIGSRvM25NnHojesghChQTQ5Ds1Bmx1KOjDJ7NtsgIgE2ST1r6weNDNUSBxNNBszotMGJ39euNqe1czcnTVdaA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88747},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"22f6f8b78246bf63993b872baf8cea4da0d4414f","mcpName":"io.github.codespar/mcp-stripe","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Stripe — global standard-bearer payments API (PaymentIntents, Checkout, Billing, Refunds)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe_0.2.0_1777039666520_0.1633838414274309","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-stripe","version":"0.2.1","keywords":["mcp","stripe","payments","payment-intents","checkout","billing","subscriptions","refunds"],"license":"MIT","_id":"@codespar/mcp-stripe@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe":"dist/index.js"},"dist":{"shasum":"b414ec498a0603872aaed4345ee2fee7327ccfa4","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe/-/mcp-stripe-0.2.1.tgz","fileCount":6,"integrity":"sha512-5hbn0PrxpiOAjZYFa8TMBNkby8cpRpNifMQ9AEDiAWnI4You4grHUu3MrLGNMBYMakHE7D7UYFalAVvAFoXI2A==","signatures":[{"sig":"MEQCIDiftd3yZqbDD1UmKZmYDl+1jDcf5AgOu7OwQ6No4njJAiAud7p3oFuJT+4QOcOP+ZN53q1HTsT9re3Fz2dEDXBzRQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89237},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-stripe","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Stripe — global standard-bearer payments API (PaymentIntents, Checkout, Billing, Refunds)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe_0.2.1_1777123272676_0.14132119663822373","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-stripe","version":"0.2.2","description":"MCP server for Stripe — global standard-bearer payments API (PaymentIntents, Checkout, Billing, Refunds)","type":"module","main":"./dist/index.js","bin":{"mcp-stripe":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","stripe","payments","payment-intents","checkout","billing","subscriptions","refunds"],"mcpName":"io.github.codespar/mcp-stripe","_id":"@codespar/mcp-stripe@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-fsL8CZTP1kBNG1hh3WYtbQmq92Sy5m0LnI6zF2hId+Z4DhddXg/lbzMhApHu0utPv2j+/31p67huR8YSuux3SA==","shasum":"cc8ad51156b35c375eacce311e874a6e23abfb12","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe/-/mcp-stripe-0.2.2.tgz","fileCount":6,"unpackedSize":90534,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICrwlyXCjGuo0WM6baPbXOhkKt6A3/huw5WpWVxql0nIAiBjtLPZuAUhFmqY9N3ywuOJZhLbUSA4xxNP2ceplXSkSA=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-stripe_0.2.2_1782153974991_0.9803248558127995"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:55:38.605Z","modified":"2026-06-22T18:46:15.284Z","0.1.0":"2026-04-24T01:55:38.850Z","0.2.0":"2026-04-24T14:07:46.651Z","0.2.1":"2026-04-25T13:21:12.842Z","0.2.2":"2026-06-22T18:46:15.127Z"},"license":"MIT","keywords":["mcp","stripe","payments","payment-intents","checkout","billing","subscriptions","refunds"],"description":"MCP server for Stripe — global standard-bearer payments API (PaymentIntents, Checkout, Billing, Refunds)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-stripe\n\n> MCP server for **Stripe** — global standard-bearer payments API\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-stripe)](https://www.npmjs.com/package/@codespar/mcp-stripe)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Stripe vs. Stripe ACP\n\nTwo Stripe MCP servers live in the CodeSpar catalog — different products:\n\n| Package | Wraps | When to use |\n|---|---|---|\n| **`@codespar/mcp-stripe`** (this package) | Stripe's regular payments API (PaymentIntents, Checkout, Billing) | You are already using Stripe to accept payments today — the 99% case for LatAm SaaS that ship with Stripe. |\n| `@codespar/mcp-stripe-acp` | Stripe's Agentic Commerce Protocol | You are building on Stripe's new agent-native checkout spec. Much narrower product, bleeding edge. |\n\nIf you are a typical SaaS with Stripe as your PSP, **this is the package**.\n\n## Why Stripe in the CodeSpar catalog?\n\nStripe is the global standard-bearer for developer-first payments. Nearly every LatAm SaaS that bills international cards ships with Stripe — Truora, Platzi, Rappi Pay (for some flows), countless Y Combinator LatAm companies. Adding Stripe lets agents operate the payments stack those SaaS already run, without forcing a migration to a local-first gateway.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"stripe\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-stripe\"],\n      \"env\": {\n        \"STRIPE_SECRET_KEY\": \"sk_test_...\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add stripe -- npx @codespar/mcp-stripe\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"stripe\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-stripe\"],\n      \"env\": {\n        \"STRIPE_SECRET_KEY\": \"sk_test_...\"\n      }\n    }\n  }\n}\n```\n\n## Tools (30)\n\n| Tool | Purpose |\n|---|---|\n| `create_payment_intent` | Create a PaymentIntent — Stripe's modern primitive for charging a customer. |\n| `confirm_payment_intent` | Confirm a PaymentIntent created with confirm=false. |\n| `retrieve_payment_intent` | Retrieve a PaymentIntent by id. |\n| `cancel_payment_intent` | Cancel a PaymentIntent. |\n| `list_payment_intents` | List PaymentIntents. |\n| `create_refund` | Refund a charge or a PaymentIntent. |\n| `list_refunds` | List Refunds. |\n| `create_customer` | Create a Stripe Customer. |\n| `retrieve_customer` | Retrieve a Customer by id. |\n| `update_customer` | Update a Customer. |\n| `create_product` | Create a Product — the catalog entity Prices reference. |\n| `list_products` | List Products. |\n| `create_price` | Create a Price attached to a Product. |\n| `list_prices` | List Prices. |\n| `create_subscription` | Create a Subscription for an existing customer. |\n| `update_subscription` | Update a Subscription. |\n| `cancel_subscription` | Cancel a Subscription. |\n| `list_subscriptions` | List Subscriptions. |\n| `create_checkout_session` | Create a hosted Checkout Session. |\n| `create_payment_link` | Create a long-lived Payment Link (shareable URL) that charges a price or set of line items. |\n| `list_payment_links` | List Payment Links. |\n| `create_invoice` | Create an Invoice draft for a customer. |\n| `list_invoices` | List Invoices. |\n| `finalize_invoice` | Finalize a draft Invoice. |\n| `send_invoice` | Send a finalized Invoice to the customer by email. |\n| `pay_invoice` | Attempt to collect payment on an open Invoice. |\n| `void_invoice` | Void a finalized Invoice. |\n| `update_dispute` | Submit evidence on a Dispute. |\n| `list_disputes` | List Disputes. |\n| `retrieve_balance` | Retrieve the current Stripe account balance — available, pending, and connect_reserved funds broken down by... |\n\n## Authentication\n\nStripe uses a single secret key. The key prefix selects the environment:\n\n- `sk_test_...` → test mode (no real money moves)\n- `sk_live_...` → live mode\n\nThere is **no separate base URL** — the key itself routes requests. Set `STRIPE_SECRET_KEY` and you are done.\n\nRequest bodies are `application/x-www-form-urlencoded` with bracket notation (`customer[name]=Foo`, `metadata[order]=123`, `expand[]=latest_invoice`). This server handles nested objects and arrays for you.\n\n### Pinning an API version\n\nStripe auto-upgrades breaking changes on a calendar cadence. If you want to lock the version your agent sees, set `STRIPE_API_VERSION` (e.g. `2024-06-20`). The server passes it as the `Stripe-Version` header on every call.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `STRIPE_SECRET_KEY` | Yes | `sk_test_...` or `sk_live_...` from Stripe Dashboard > Developers > API keys |\n| `STRIPE_API_VERSION` | No | Pin API version via the `Stripe-Version` header (e.g. `2024-06-20`) |\n\n## Sandbox / Testing\n\nEvery Stripe account has test mode built in — no separate signup. Use a `sk_test_...` key and any of Stripe's [test cards](https://stripe.com/docs/testing) (e.g. `4242 4242 4242 4242`).\n\n### Get your credentials\n\n1. Sign up at [stripe.com](https://stripe.com)\n2. Go to Dashboard > Developers > API keys\n3. Copy your **Secret key** (test mode by default)\n4. Set `STRIPE_SECRET_KEY`\n\n## Roadmap\n\n### v0.2 (planned)\n- `update_payment_intent`, `capture_payment_intent` (separate capture)\n- `retrieve_refund`, `list_refunds`\n- `list_customers`, `search_customers`\n- `update_subscription`, `retrieve_subscription`\n- `retrieve_invoice`, `finalize_invoice`, `pay_invoice`, `send_invoice`, `void_invoice`\n- `create_invoice_item`, `list_invoice_items`\n- `create_price`, `create_product`\n- `list_charges`, `retrieve_charge`\n- `retrieve_dispute`, `close_dispute`, `list_disputes`\n\n### v0.3 (planned)\n- Stripe Connect: accounts, account links, transfers, payouts\n- `create_setup_intent`, `confirm_setup_intent` (saving cards for later)\n- PaymentMethod attach / detach / list\n- Webhook event construction helper\n\nWant a tool sooner? [Open an issue](https://github.com/codespar/mcp-dev-latam/issues) or [PR](https://github.com/codespar/mcp-dev-latam).\n\n## Links\n\n- [Stripe website](https://stripe.com)\n- [Stripe API docs](https://stripe.com/docs/api)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, spend caps, and audit trails for agent-initiated charges, refunds, and subscription changes? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}