Payport

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 1, 2026

Customers, products, prices, invoices, and payments through the Stripe API.

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手管理 Stripe 账户：客户、商品、价格、支付链接、发票、退款、优惠券、争议和订阅。

可以做什么
  • 创建和列出客户、商品、价格与优惠券
  • 创建托管支付链接并列出支付意图
  • 创建草稿发票、添加明细行、完成发票并列出发票
  • 查询账户余额并创建全额或部分退款
  • 列出争议、添加证据并可选择提交
  • 列出、更新和取消订阅
适用场景
适合让助手在对话或代理流程中处理日常 Stripe 计费事务：录入客户、搭建商品目录、发送支付链接或发票、查看余额、退款，以及管理订阅和争议。
运行要求
以本地 stdio 进程运行，可通过 npx 或 Docker 镜像启动。需要在 STRIPE_SECRET_KEY 环境变量中提供 Stripe 密钥，缺失时所有操作都会失败。需要访问 Stripe API 的网络连接。
安装前请注意
该密钥拥有 Stripe 账户的完整权限，并会作为 Bearer 令牌发送给 Stripe。多数工具会写入或更改与真实资金相关的数据：创建客户、价格、支付链接、发票、退款、优惠券，完成发票，提交争议证据，更新或取消订阅。退款和完成发票会实际动账，执行前应确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Payport，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

payport

payport gives an agent a working doorway into a Stripe account: open a customer record, put a product and a price in the catalog, hand a buyer a hosted payment link, draft an invoice and finalize it, check the balance, refund a payment, issue a coupon, answer a dispute, and manage subscriptions. Each operation is one call against the Stripe REST API, and the API's JSON answer comes back as-is. It runs from the command line or as an MCP server for agents.

A Stripe secret key is required. Put it in the STRIPE_SECRET_KEY environment variable; the key is sent to the API as a Bearer token and never appears in output. When the variable is missing, every operation fails with an error that names it.

Install

bash
npx @reneturcios/payport list-customers --limit 5

Or run the container image:

bash
docker run -i -e STRIPE_SECRET_KEY ghcr.io/cloudcorprecords/payport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
export STRIPE_SECRET_KEY="your secret key"
payport create-customer --name "Ada Lovelace" --email [email protected]payport list-customers --email [email protected] --limit 5payport create-product --name "Trail Guide" --description "A field guide"payport list-products --limit 10payport retrieve-balance
payport --version

Exit codes: 0 on success, 1 when an API call fails (including a missing STRIPE_SECRET_KEY), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/payport mcp

MCP client configuration:

json
{  "mcpServers": {    "payport": {      "command": "npx",      "args": ["-y", "@reneturcios/payport", "mcp"],      "env": { "STRIPE_SECRET_KEY": "your secret key" }    }  }}

Tools

ToolInputWhat it does
create_customername (string, required), email (string, optional)Create a customer.
list_customersemail (string, optional), limit (integer, optional)List customers, optionally filtered by exact email.
create_productname (string, required), description (string, optional)Create a catalog product.
list_productslimit (integer, optional)List products.
create_priceproduct, currency, unit_amount (all required)Create a price for a product; unit_amount is in the smallest currency unit.
list_pricesproduct (optional), limit (optional)List prices, optionally for one product.
create_payment_linkprice, quantity (required), redirect_url (optional)Create a hosted payment link.
list_payment_intentscustomer (optional), limit (optional)List payment intents.
create_invoicecustomer (required), days_until_due (optional)Create a draft invoice sent by email (send_invoice).
create_invoice_itemcustomer, price, invoice (all required)Add a priced line item to a draft invoice.
list_invoicescustomer (optional), limit (optional)List invoices.
finalize_invoiceinvoice (required)Finalize a draft invoice.
retrieve_balance—Retrieve the account balance.
create_refundpayment_intent (required), amount (optional)Refund a payment intent, in full or in part.
create_couponduration (required), percent_off, amount_off, currency, name, duration_in_months (optional)Create a coupon.
list_couponslimit (optional)List coupons.
list_disputescharge, payment_intent, limit (all optional)List disputes.
update_disputedispute (required), evidence (object, optional), submit (boolean, optional)Add evidence to a dispute and optionally submit it.
list_subscriptionscustomer, status, limit (all optional)List subscriptions.
cancel_subscriptionsubscription (required)Cancel a subscription.
update_subscriptionsubscription (required), price, cancel_at_period_end (optional)Update a subscription.

This is the documented core subset of the Stripe agent toolkit's 22-tool MCP set: search_stripe_documentation (a hosted documentation search, not a Stripe API operation) is not implemented.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

来源：README.md，提交 525961b

工具

21

create_customer

Create a customer in Stripe.

输入参数name必填email

list_customers

List customers in Stripe, optionally filtered by email.

输入参数emaillimit

create_product

Create a product in Stripe.

输入参数name必填description

list_products

List products in Stripe.

输入参数limit

create_price

Create a price for a product in Stripe.

输入参数product必填currency必填unit_amount必填

list_prices

List prices in Stripe, optionally for one product.

输入参数limitproduct

list_payment_intents

List payment intents in Stripe, optionally for one customer.

输入参数limitcustomer

create_invoice

Create a draft invoice for a customer in Stripe.

输入参数customer必填days_until_due

create_invoice_item

Add a priced line item to a draft invoice in Stripe.

输入参数price必填invoice必填customer必填

list_invoices

List invoices in Stripe, optionally for one customer.

输入参数limitcustomer

finalize_invoice

Finalize a draft invoice in Stripe so it can be paid.

输入参数invoice必填

retrieve_balance

Retrieve the Stripe account balance.

无需输入参数。

create_refund

Create a refund for a payment intent in Stripe.

输入参数amountpayment_intent必填

create_coupon

Create a coupon in Stripe.

输入参数namecurrencyduration必填amount_offpercent_offduration_in_months

list_coupons

List coupons in Stripe.

输入参数limit

list_disputes

List disputes in Stripe, optionally filtered by charge or payment intent.

输入参数limitchargepayment_intent

update_dispute

Update a dispute in Stripe with evidence, optionally submitting it.

输入参数submitdispute必填evidence

list_subscriptions

List subscriptions in Stripe, optionally filtered by customer or status.

输入参数limitstatuscustomer

cancel_subscription

Cancel a subscription in Stripe.

输入参数subscription必填

update_subscription

Update a subscription in Stripe, for example its price or cancellation timing.

输入参数pricesubscription必填cancel_at_period_end

版本历史

1
  1. v0.1.0最新Nov 1, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分