@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

1. Go to Stripe Dashboard
2. Copy your secret key (or create a restricted key with specific permissions)
3. For ACP: configure your seller's ACP endpoint URL
4. 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.

Links

• ACP Specification
• ACP GitHub
• Stripe Agent Toolkit
• Stripe API Documentation
• MCP Dev Brasil
• Landing Page

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