Mcp Stripe

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

MCP server for Stripe — global payments API (PaymentIntents, Checkout, Billing, Refunds)

發布方自己的服務：Stripe

已驗證STDIO僅桌面金融商業與電商

服務詳細資訊

識別碼: io.github.codespar/mcp-stripe
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 codespar。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-stripe.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-stripe?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

讓助理操作 Stripe 帳戶：建立與確認付款、退款、客戶、商品、價格、訂閱、發票、付款連結與爭議。

可以做什麼: 這是一個包裝 Stripe 付款 API 的本機 MCP 伺服器，提供約 30 個工具。涵蓋 PaymentIntent（建立、確認、查詢、取消、列表）、退款、客戶、商品與價格、訂閱、託管 Checkout 工作階段與付款連結、發票（建立、定稿、寄送、收款、作廢）、爭議以及帳戶餘額查詢。它會代為處理 Stripe 的表單編碼請求內容，包括巢狀物件與陣列。
適用情境: 適合已使用 Stripe 作為付款服務商、希望助理直接在對話中讀取或操作該帳戶的團隊，例如查看餘額與爭議、草擬發票，或建立客戶、價格與訂閱。每個 Stripe 帳戶都內建測試模式，可先用測試金鑰試用。
執行需求: 透過 stdio 在本機執行，通常以 npx 從 npm 套件 @codespar/mcp-stripe 啟動，因此需要 Node.js。需要 Stripe 帳戶，並設定環境變數 STRIPE_SECRET_KEY（來自 Stripe 後台的測試或正式金鑰）。可選設定 STRIPE_API_VERSION 固定 API 版本。僅支援桌面用戶端，且需要連線至 Stripe 的網路。

安裝前請注意

STRIPE_SECRET_KEY 是具完整權限的金鑰：正式金鑰（sk_live_...）可讓助理動用真實資金、發起退款、變更訂閱並寄送發票，測試金鑰（sk_test_...）則不會。在驗證行為之前應優先使用測試金鑰，並妥善保管該金鑰。相關工具會寫入與修改資料，寄送發票會向客戶寄出電子郵件。

安裝

在 SourceWeft 中

開啟儀表板中的 Mcp Stripe，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

README

@codespar/mcp-stripe

MCP server for Stripe — global standard-bearer payments API

[npm] [License: MIT]

Stripe vs. Stripe ACP

Two Stripe MCP servers live in the CodeSpar catalog — different products:

Package	Wraps	When to use
`@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.
`@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.

If you are a typical SaaS with Stripe as your PSP, this is the package.

Why Stripe in the CodeSpar catalog?

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

Quick Start

Claude Desktop

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

json

{  "mcpServers": {    "stripe": {      "command": "npx",      "args": ["-y", "@codespar/mcp-stripe"],      "env": {        "STRIPE_SECRET_KEY": "sk_test_..."      }    }  }}

{  "mcpServers": {    "stripe": {      "command": "npx",      "args": ["-y", "@codespar/mcp-stripe"],      "env": {        "STRIPE_SECRET_KEY": "sk_test_..."      }    }  }}

Claude Code

Cursor / VS Code

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

json

{  "servers": {    "stripe": {      "command": "npx",      "args": ["-y", "@codespar/mcp-stripe"],      "env": {        "STRIPE_SECRET_KEY": "sk_test_..."      }    }  }}

{  "servers": {    "stripe": {      "command": "npx",      "args": ["-y", "@codespar/mcp-stripe"],      "env": {        "STRIPE_SECRET_KEY": "sk_test_..."      }    }  }}

Tools (30)

Tool	Purpose
`create_payment_intent`	Create a PaymentIntent — Stripe's modern primitive for charging a customer.
`confirm_payment_intent`	Confirm a PaymentIntent created with confirm=false.
`retrieve_payment_intent`	Retrieve a PaymentIntent by id.
`cancel_payment_intent`	Cancel a PaymentIntent.
`list_payment_intents`	List PaymentIntents.
`create_refund`	Refund a charge or a PaymentIntent.
`list_refunds`	List Refunds.
`create_customer`	Create a Stripe Customer.
`retrieve_customer`	Retrieve a Customer by id.
`update_customer`	Update a Customer.
`create_product`	Create a Product — the catalog entity Prices reference.
`list_products`	List Products.
`create_price`	Create a Price attached to a Product.
`list_prices`	List Prices.
`create_subscription`	Create a Subscription for an existing customer.
`update_subscription`	Update a Subscription.
`cancel_subscription`	Cancel a Subscription.
`list_subscriptions`	List Subscriptions.
`create_checkout_session`	Create a hosted Checkout Session.
`create_payment_link`	Create a long-lived Payment Link (shareable URL) that charges a price or set of line items.
`list_payment_links`	List Payment Links.
`create_invoice`	Create an Invoice draft for a customer.
`list_invoices`	List Invoices.
`finalize_invoice`	Finalize a draft Invoice.
`send_invoice`	Send a finalized Invoice to the customer by email.
`pay_invoice`	Attempt to collect payment on an open Invoice.
`void_invoice`	Void a finalized Invoice.
`update_dispute`	Submit evidence on a Dispute.
`list_disputes`	List Disputes.
`retrieve_balance`	Retrieve the current Stripe account balance — available, pending, and connect_reserved funds broken down by...

Authentication

Stripe uses a single secret key. The key prefix selects the environment:

sk_test_... → test mode (no real money moves)
sk_live_... → live mode

There is no separate base URL — the key itself routes requests. Set STRIPE_SECRET_KEY and you are done.

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

Pinning an API version

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

Environment Variables

Variable	Required	Description
`STRIPE_SECRET_KEY`	Yes	`sk_test_...` or `sk_live_...` from Stripe Dashboard > Developers > API keys
`STRIPE_API_VERSION`	No	Pin API version via the `Stripe-Version` header (e.g. `2024-06-20`)

Sandbox / Testing

Every Stripe account has test mode built in — no separate signup. Use a sk_test_... key and any of Stripe's test cards (e.g. 4242 4242 4242 4242).

Get your credentials

Sign up at stripe.com
Go to Dashboard > Developers > API keys
Copy your Secret key (test mode by default)
Set STRIPE_SECRET_KEY

Roadmap

v0.2 (planned)

update_payment_intent, capture_payment_intent (separate capture)
retrieve_refund, list_refunds
list_customers, search_customers
update_subscription, retrieve_subscription
retrieve_invoice, finalize_invoice, pay_invoice, send_invoice, void_invoice
create_invoice_item, list_invoice_items
create_price, create_product
list_charges, retrieve_charge
retrieve_dispute, close_dispute, list_disputes

v0.3 (planned)

Stripe Connect: accounts, account links, transfers, payouts
create_setup_intent, confirm_setup_intent (saving cards for later)
PaymentMethod attach / detach / list
Webhook event construction helper

Want a tool sooner? Open an issue or PR.

Enterprise

Need governance, spend caps, and audit trails for agent-initiated charges, refunds, and subscription changes? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.