payport

payport

payport を使うと、エージェントは Stripe アカウントを操作できます。顧客レコードを開き、カタログに商品と価格を登録し、購入者にホスト型決済リンクを渡し、請求書を作成して確定し、残高を確認し、支払いを返金し、クーポンを発行し、異議申し立てに対応し、サブスクリプションを管理できます。各操作は Stripe REST API への 1 回の呼び出しで行われ、API の JSON レスポンスがそのまま返されます。コマンドラインから実行することも、エージェント向けの MCP サーバーとして実行することもできます。

Stripe のシークレットキーが必要です。STRIPE_SECRET_KEY 環境変数に設定してください。このキーは Bearer トークンとして API に送信され、出力には表示されません。環境変数が設定されていない場合、すべての操作はその変数名を含むエラーで失敗します。

インストール

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

または、コンテナーイメージを実行します。

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

コンテナーはデフォルトで MCP サーバーを起動します（下記参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

export STRIPE_SECRET_KEY="your secret key"

payport create-customer --name "Ada Lovelace" --email [email protected]
payport list-customers --email [email protected] --limit 5
payport create-product --name "Trail Guide" --description "A field guide"
payport list-products --limit 10
payport retrieve-balance

payport --version

終了コード：成功時は 0、API 呼び出しの失敗時（STRIPE_SECRET_KEY の未設定を含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方の使い方に対応します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/payport mcp

MCP クライアントの設定：

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

ツール

ツール	入力	機能
create_customer	name（文字列、必須）、email（文字列、任意）	顧客を作成します。
list_customers	email（文字列、任意）、limit（整数、任意）	顧客を一覧表示します。必要に応じて完全一致するメールアドレスで絞り込めます。
create_product	name（文字列、必須）、description（文字列、任意）	カタログ商品を作成します。
list_products	limit（整数、任意）	商品を一覧表示します。
create_price	product、currency、unit_amount（すべて必須）	商品の価格を作成します。unit_amount は通貨の最小単位で指定します。
list_prices	product（任意）、limit（任意）	価格を一覧表示します。必要に応じて 1 つの商品に絞り込めます。
create_payment_link	price、quantity（必須）、redirect_url（任意）	ホスト型決済リンクを作成します。
list_payment_intents	customer（任意）、limit（任意）	支払いインテントを一覧表示します。
create_invoice	customer（必須）、days_until_due（任意）	メールで送信する下書き請求書（send_invoice）を作成します。
create_invoice_item	customer、price、invoice（すべて必須）	下書き請求書に価格付きの明細項目を追加します。
list_invoices	customer（任意）、limit（任意）	請求書を一覧表示します。
finalize_invoice	invoice（必須）	下書き請求書を確定します。
retrieve_balance	—	アカウント残高を取得します。
create_refund	payment_intent（必須）、amount（任意）	支払いインテントの全額または一部を返金します。
create_coupon	duration（必須）、percent_off、amount_off、currency、name、duration_in_months（任意）	クーポンを作成します。
list_coupons	limit（任意）	クーポンを一覧表示します。
list_disputes	charge、payment_intent、limit（すべて任意）	異議申し立てを一覧表示します。
update_dispute	dispute（必須）、evidence（オブジェクト、任意）、submit（ブール値、任意）	異議申し立てに証拠を追加し、必要に応じて提出します。
list_subscriptions	customer、status、limit（すべて任意）	サブスクリプションを一覧表示します。
cancel_subscription	subscription（必須）	サブスクリプションをキャンセルします。
update_subscription	subscription（必須）、price、cancel_at_period_end（任意）	サブスクリプションを更新します。

これは、Stripe エージェントツールキットの 22 ツール MCP セットのうち、ドキュメント化されている主要なサブセットです。search_stripe_documentation（Stripe API 操作ではなく、ホスト型のドキュメント検索）は実装されていません。

開発

npm install
npm 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

ライセンス

MIT — LICENSE を参照してください。