Stripe ACP

io.github.codespar/mcp-stripe-acp

Documentation

@codespar/mcp-stripe-acp

MCP server for Stripe ACP — Agentic Commerce Protocol for AI agent checkout, payment delegation, and product management

What is Stripe ACP?

The 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.

ACP is live in ChatGPT with 1M+ Shopify merchants connected.

This MCP server covers both ACP protocol operations (checkout sessions, payment delegation) and standard Stripe API operations (customers, products, invoices, subscriptions).

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_...",
        "STRIPE_ACP_BASE": "https://seller.example.com/acp"
      }
    }
  }
}

Claude Code

claude mcp add stripe-acp -- npx @codespar/mcp-stripe-acp

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_...",
        "STRIPE_ACP_BASE": "https://seller.example.com/acp"
      }
    }
  }
}

Tools (24)

Tool	Purpose
`create_checkout`	Create an ACP checkout session with a seller.
`get_checkout`	Retrieve the current state of an ACP checkout session, including status, pricing, and available payment met...
`update_checkout`	Update an ACP checkout session — modify quantities, shipping address, or fulfillment selections
`complete_checkout`	Complete an ACP checkout by submitting a payment token.
`cancel_checkout`	Cancel an ACP checkout session.
`create_customer`	Create a Stripe customer
`list_customers`	List Stripe customers with optional filters
`create_payment_link`	Create a shareable Stripe Payment Link for a price
`list_payment_intents`	List Stripe payment intents with optional filters
`create_refund`	Refund a Stripe payment intent or charge
`get_balance`	Get Stripe account balance
`list_products`	List products in the Stripe catalog
`create_product`	Create a new product in Stripe
`list_prices`	List prices for Stripe products
`create_invoice`	Create a draft invoice for a customer
`list_subscriptions`	List active Stripe subscriptions
`create_subscription`	Create a subscription for a customer with a recurring price
`cancel_subscription`	Cancel a Stripe subscription immediately or at period end
`create_invoice_item`	Add a line item to an upcoming or specific invoice
`finalize_invoice`	Finalize a draft invoice so it can be paid
`create_coupon`	Create a discount coupon
`list_disputes`	List payment disputes (chargebacks)
`create_checkout_session`	Create a Stripe Checkout Session (hosted payment page)
`get_account`	Get Stripe account info for the authenticated account

Authentication

Stripe uses a secret API key (or restricted key for production). Use test mode keys (sk_test_...) for development.

Get your credentials

Go to Stripe Dashboard
Copy your secret key (or create a restricted key with specific permissions)
For ACP: configure your seller's ACP endpoint URL
Set the environment variables

Environment Variables

Variable	Required	Description
`STRIPE_API_KEY`	Yes	Stripe secret or restricted API key
`STRIPE_ACP_BASE`	No	Seller's ACP endpoint base URL (required for ACP tools)

ACP Checkout Flow

1. Agent calls create_checkout → sends items + buyer info
2. Seller returns pricing, shipping options, payment handlers
3. Agent calls update_checkout → selects shipping, updates address
4. Checkout reaches "ready_for_payment" status
5. Agent calls complete_checkout → submits payment token
6. Seller processes payment → order confirmed

Roadmap

v0.2 (planned)

search_products — Search catalog by query
create_checkout_link — Generate ACP checkout URL
get_order_status — Track order post-checkout
list_payment_handlers — Discover available payment methods

v0.3 (planned)

SharedPaymentToken creation and management
Webhook support for checkout status updates
Multi-seller checkout orchestration

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT