{"_id":"@codespar/mcp-stripe-acp","_rev":"6-15d245a1f6a262544f0690ae1fb56f81","name":"@codespar/mcp-stripe-acp","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@codespar/mcp-stripe-acp","version":"0.1.0","keywords":["mcp","stripe","acp","agentic-commerce","checkout","payment-delegation","ai-agent","agent-commerce-protocol"],"license":"MIT","_id":"@codespar/mcp-stripe-acp@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe-acp":"dist/index.js"},"dist":{"shasum":"0d1576f48c06447f2ba7ab24df1391d6b1d45658","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe-acp/-/mcp-stripe-acp-0.1.0.tgz","fileCount":5,"integrity":"sha512-BEQV9rpejsABQUNpp2Xhnhb483JTDQ/fLORT0dt+d4iKP55vuRudZDZ9xf10url1XyCzc7LM9QtcTr09ZpoGxQ==","signatures":[{"sig":"MEQCIDnfu7oSDEdSQDq2aBpbjS+MrtdmQrMnSaHO45D8kZVHAiBbC0xnVo1DWCGtm85t8MoIhMXCbo8pE3b1Vf0tLLYPkg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47350},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"407310ff60d4f2b1799152d53eb9338c1a913d1f","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 ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product discovery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe-acp_0.1.0_1775611188339_0.6207790270575018","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@codespar/mcp-stripe-acp","version":"0.1.1","keywords":["mcp","stripe","acp","agentic-commerce","checkout","payment-delegation","ai-agent","agent-commerce-protocol"],"license":"MIT","_id":"@codespar/mcp-stripe-acp@0.1.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe-acp":"dist/index.js"},"dist":{"shasum":"801896da890b641f12e1f4244790f32b0ded80de","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe-acp/-/mcp-stripe-acp-0.1.1.tgz","fileCount":4,"integrity":"sha512-pKS4rp7ddvE9/+Pk5VjRwM6MJVaeXzAQgxsRW7M1xJFUu3FT1ld/lWz42UEZbSz1+m9PHKgfQWK+xRBoMXo+5Q==","signatures":[{"sig":"MEUCIQC8lUTIsf0jRljwjWZdogTk/bOa3KUEuAKNJT9s6avE3gIgIE3QjZwhIyWJh+FDRmKcvknSlZt9f1lWlhIpUiZYEUA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29427},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"addd0a1b4db9cce64f3e2fe4a94eb122f9989442","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 ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product discovery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe-acp_0.1.1_1775644752443_0.06974863001516707","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-stripe-acp","version":"0.1.2","keywords":["mcp","stripe","acp","agentic-commerce","checkout","payment-delegation","ai-agent","agent-commerce-protocol"],"license":"MIT","_id":"@codespar/mcp-stripe-acp@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe-acp":"dist/index.js"},"dist":{"shasum":"7535cdb7407bf03aa665a380be5187d339609c9f","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe-acp/-/mcp-stripe-acp-0.1.2.tgz","fileCount":4,"integrity":"sha512-PSY2X7natD88VE5VOLmzubJ0KFYDfw5bLpKKiVFDxWrVoFNdtlnQv+HNkm2+vwFoc+xTGxndj23a2Eb+NpETwA==","signatures":[{"sig":"MEUCIDutKduAnK7Q75CpJNrJDGVxmzm1zVQgtg2jyPvZFoQHAiEAqQlJG9RbSgtYMpKczuL52wO8hRjCvSyrh7hMjz43ruc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32024},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-stripe-acp","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 ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product discovery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe-acp_0.1.2_1775953799156_0.5172207632650772","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@codespar/mcp-stripe-acp","version":"0.1.3","keywords":["mcp","stripe","acp","agentic-commerce","checkout","payment-delegation","ai-agent","agent-commerce-protocol"],"license":"MIT","_id":"@codespar/mcp-stripe-acp@0.1.3","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stripe-acp":"dist/index.js"},"dist":{"shasum":"4ea8a57a90287a0e2559d2b43a63110daf15245a","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe-acp/-/mcp-stripe-acp-0.1.3.tgz","fileCount":4,"integrity":"sha512-WmFaF9f59zF0GFu9ETTtXptN0QEDxYd/eu7l4d2Vnq1gfEGGU91N3rMouw7y82XC9/jVI8G48B+Or/++xt6yMg==","signatures":[{"sig":"MEYCIQDildv94e3VgfBzE+VuMRgwgSBPCcVUKD38s8L7eAZTpwIhAJgyhrixw6bgRdOILd43wS0cipO5SnSHEl4pF05ZuUR2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42713},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-stripe-acp","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 ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product discovery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stripe-acp_0.1.3_1777123268713_0.5930269446278158","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@codespar/mcp-stripe-acp","version":"0.1.4","description":"MCP server for Stripe ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product discovery","type":"module","main":"./dist/index.js","bin":{"mcp-stripe-acp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","stripe","acp","agentic-commerce","checkout","payment-delegation","ai-agent","agent-commerce-protocol"],"mcpName":"io.github.codespar/mcp-stripe-acp","_id":"@codespar/mcp-stripe-acp@0.1.4","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-OWe0MWpfMJz/6Lpr2X+V+eIA01edvbQ2Wk7OTPJEALLogDpqyuxFsnwRoC2yAe37x3yWVg8FrRWpYNCTMLJVOw==","shasum":"7c872c8f08f2131e97a61874d4a9c1435e3db16d","tarball":"https://registry.npmjs.org/@codespar/mcp-stripe-acp/-/mcp-stripe-acp-0.1.4.tgz","fileCount":4,"unpackedSize":43192,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDdtcdYJ1dDbwbQNEutvq2Jrqgmo2YK1eVovjwwNzj7kAIgEQs4+9OreC8dZNnKiyTmGhQnoqHTTaiz/HzyYF5FHGA="}]},"_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-acp_0.1.4_1782153967386_0.41440732880689546"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-08T01:19:48.232Z","modified":"2026-06-22T18:46:07.661Z","0.1.0":"2026-04-08T01:19:48.495Z","0.1.1":"2026-04-08T10:39:12.606Z","0.1.2":"2026-04-12T00:29:59.325Z","0.1.3":"2026-04-25T13:21:08.883Z","0.1.4":"2026-06-22T18:46:07.508Z"},"license":"MIT","keywords":["mcp","stripe","acp","agentic-commerce","checkout","payment-delegation","ai-agent","agent-commerce-protocol"],"description":"MCP server for Stripe ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product discovery","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-stripe-acp\n\n> MCP server for **Stripe ACP** — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product management\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-stripe-acp)](https://www.npmjs.com/package/@codespar/mcp-stripe-acp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## What is Stripe ACP?\n\nThe **Agentic Commerce Protocol (ACP)** is an open standard co-developed by Stripe and OpenAI. It enables AI agents to complete purchases on behalf of users — the agent handles the checkout UX, while the seller handles inventory, pricing, and payment processing.\n\nACP is live in ChatGPT with 1M+ Shopify merchants connected.\n\nThis MCP server covers both **ACP protocol operations** (checkout sessions, payment delegation) and **standard Stripe API operations** (customers, products, invoices, subscriptions).\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-acp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-stripe-acp\"],\n      \"env\": {\n        \"STRIPE_API_KEY\": \"sk_test_...\",\n        \"STRIPE_ACP_BASE\": \"https://seller.example.com/acp\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add stripe-acp -- npx @codespar/mcp-stripe-acp\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"stripe-acp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-stripe-acp\"],\n      \"env\": {\n        \"STRIPE_API_KEY\": \"sk_test_...\",\n        \"STRIPE_ACP_BASE\": \"https://seller.example.com/acp\"\n      }\n    }\n  }\n}\n```\n\n## Tools (24)\n\n| Tool | Purpose |\n|---|---|\n| `create_checkout` | Create an ACP checkout session with a seller. |\n| `get_checkout` | Retrieve the current state of an ACP checkout session, including status, pricing, and available payment met... |\n| `update_checkout` | Update an ACP checkout session — modify quantities, shipping address, or fulfillment selections |\n| `complete_checkout` | Complete an ACP checkout by submitting a payment token. |\n| `cancel_checkout` | Cancel an ACP checkout session. |\n| `create_customer` | Create a Stripe customer |\n| `list_customers` | List Stripe customers with optional filters |\n| `create_payment_link` | Create a shareable Stripe Payment Link for a price |\n| `list_payment_intents` | List Stripe payment intents with optional filters |\n| `create_refund` | Refund a Stripe payment intent or charge |\n| `get_balance` | Get Stripe account balance |\n| `list_products` | List products in the Stripe catalog |\n| `create_product` | Create a new product in Stripe |\n| `list_prices` | List prices for Stripe products |\n| `create_invoice` | Create a draft invoice for a customer |\n| `list_subscriptions` | List active Stripe subscriptions |\n| `create_subscription` | Create a subscription for a customer with a recurring price |\n| `cancel_subscription` | Cancel a Stripe subscription immediately or at period end |\n| `create_invoice_item` | Add a line item to an upcoming or specific invoice |\n| `finalize_invoice` | Finalize a draft invoice so it can be paid |\n| `create_coupon` | Create a discount coupon |\n| `list_disputes` | List payment disputes (chargebacks) |\n| `create_checkout_session` | Create a Stripe Checkout Session (hosted payment page) |\n| `get_account` | Get Stripe account info for the authenticated account |\n\n## Authentication\n\nStripe uses a secret API key (or restricted key for production). Use test mode keys (`sk_test_...`) for development.\n\n### Get your credentials\n\n1. Go to [Stripe Dashboard](https://dashboard.stripe.com/apikeys)\n2. Copy your secret key (or create a restricted key with specific permissions)\n3. For ACP: configure your seller's ACP endpoint URL\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `STRIPE_API_KEY` | Yes | Stripe secret or restricted API key |\n| `STRIPE_ACP_BASE` | No | Seller's ACP endpoint base URL (required for ACP tools) |\n\n## ACP Checkout Flow\n\n```\n1. Agent calls create_checkout → sends items + buyer info\n2. Seller returns pricing, shipping options, payment handlers\n3. Agent calls update_checkout → selects shipping, updates address\n4. Checkout reaches \"ready_for_payment\" status\n5. Agent calls complete_checkout → submits payment token\n6. Seller processes payment → order confirmed\n```\n\n## Roadmap\n\n### v0.2 (planned)\n- `search_products` — Search catalog by query\n- `create_checkout_link` — Generate ACP checkout URL\n- `get_order_status` — Track order post-checkout\n- `list_payment_handlers` — Discover available payment methods\n\n### v0.3 (planned)\n- SharedPaymentToken creation and management\n- Webhook support for checkout status updates\n- Multi-seller checkout orchestration\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [ACP Specification](https://www.agenticcommerce.dev)\n- [ACP GitHub](https://github.com/agentic-commerce-protocol/agentic-commerce-protocol)\n- [Stripe Agent Toolkit](https://github.com/stripe/agent-toolkit)\n- [Stripe API Documentation](https://docs.stripe.com/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, budget limits, and audit trails for agent payments? [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"}