Payport

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 1, 2026

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

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.CloudCorpRecords/payport
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Nov 1, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account CloudCorpRecords for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

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

Overview

AI-generated overview

Local MCP server that lets an assistant manage a Stripe account: customers, products, prices, payment links, invoices, refunds, coupons, disputes and…

What you can do: Create and list customers, products, prices and coupons
Create hosted payment links and list payment intents
Create draft invoices, add line items, finalize them and list invoices
Retrieve account balance and issue full or partial refunds
List disputes, add evidence and optionally submit them
List, update and cancel subscriptions
When to use it: Useful when an assistant should handle routine Stripe billing work from chat or an agent workflow: onboarding customers, building a catalog, sending payment links or invoices, checking balance, refunding, and managing subscriptions and disputes.
Requirements: Runs as a local stdio process via npx or the Docker image. Requires a Stripe secret key in the STRIPE_SECRET_KEY environment variable; without it every operation fails. Network access to the Stripe API is needed.

Before you install

The secret key grants full access to the Stripe account and is sent as a Bearer token to Stripe. Many tools write or change real money-related data: creating customers, prices, payment links, invoices, refunds, coupons, and finalizing invoices, submitting dispute evidence, updating or cancelling subscriptions. Refunds and finalized invoices move money; review actions before running them.

Installation

In SourceWeft

Open Payport in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Or run the container image:

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

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:

MCP client configuration:

json

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

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

Tools

Tool	Input	What it does
`create_customer`	`name` (string, required), `email` (string, optional)	Create a customer.
`list_customers`	`email` (string, optional), `limit` (integer, optional)	List customers, optionally filtered by exact email.
`create_product`	`name` (string, required), `description` (string, optional)	Create a catalog product.
`list_products`	`limit` (integer, optional)	List products.
`create_price`	`product`, `currency`, `unit_amount` (all required)	Create a price for a product; `unit_amount` is in the smallest currency unit.
`list_prices`	`product` (optional), `limit` (optional)	List prices, optionally for one product.
`create_payment_link`	`price`, `quantity` (required), `redirect_url` (optional)	Create a hosted payment link.
`list_payment_intents`	`customer` (optional), `limit` (optional)	List payment intents.
`create_invoice`	`customer` (required), `days_until_due` (optional)	Create a draft invoice sent by email (`send_invoice`).
`create_invoice_item`	`customer`, `price`, `invoice` (all required)	Add a priced line item to a draft invoice.
`list_invoices`	`customer` (optional), `limit` (optional)	List invoices.
`finalize_invoice`	`invoice` (required)	Finalize a draft invoice.
`retrieve_balance`	—	Retrieve the account balance.
`create_refund`	`payment_intent` (required), `amount` (optional)	Refund a payment intent, in full or in part.
`create_coupon`	`duration` (required), `percent_off`, `amount_off`, `currency`, `name`, `duration_in_months` (optional)	Create a coupon.
`list_coupons`	`limit` (optional)	List coupons.
`list_disputes`	`charge`, `payment_intent`, `limit` (all optional)	List disputes.
`update_dispute`	`dispute` (required), `evidence` (object, optional), `submit` (boolean, optional)	Add evidence to a dispute and optionally submit it.
`list_subscriptions`	`customer`, `status`, `limit` (all optional)	List subscriptions.
`cancel_subscription`	`subscription` (required)	Cancel a subscription.
`update_subscription`	`subscription` (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

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.

Source: README.md at commit 525961b

Tools

create_customer

Create a customer in Stripe.

Parametersnamerequiredemail

list_customers

List customers in Stripe, optionally filtered by email.

Parametersemaillimit

create_product

Create a product in Stripe.

Parametersnamerequireddescription

list_products

List products in Stripe.

Parameterslimit

create_price

Create a price for a product in Stripe.

Parametersproductrequiredcurrencyrequiredunit_amountrequired

list_prices

List prices in Stripe, optionally for one product.

Parameterslimitproduct

create_payment_link

Create a payment link in Stripe for a price and quantity.

Parameterspricerequiredquantityrequiredredirect_url

list_payment_intents

List payment intents in Stripe, optionally for one customer.

Parameterslimitcustomer

create_invoice

Create a draft invoice for a customer in Stripe.

Parameterscustomerrequireddays_until_due

create_invoice_item

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

Parameterspricerequiredinvoicerequiredcustomerrequired

list_invoices

List invoices in Stripe, optionally for one customer.

Parameterslimitcustomer

finalize_invoice

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

Parametersinvoicerequired

retrieve_balance

Retrieve the Stripe account balance.

Takes no parameters.

create_refund

Create a refund for a payment intent in Stripe.

Parametersamountpayment_intentrequired

create_coupon

Create a coupon in Stripe.

Parametersnamecurrencydurationrequiredamount_offpercent_offduration_in_months

list_coupons

List coupons in Stripe.

Parameterslimit

list_disputes

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

Parameterslimitchargepayment_intent

update_dispute

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

Parameterssubmitdisputerequiredevidence

list_subscriptions

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

Parameterslimitstatuscustomer

cancel_subscription

Cancel a subscription in Stripe.

Parameterssubscriptionrequired

update_subscription

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

Parameterspricesubscriptionrequiredcancel_at_period_end

Version history

v0.1.0LatestNov 1, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts