How do I install Payport?

Payport is a local plugin. Install it using npm package: @reneturcios/payport and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Payport safe to use?

Payport scored 5.2/10 (moderate risk) in MCP Marketplace's automated security scan. It has 2 high or critical findings to review. It's listed, but review the security report on this page before installing.

What credentials does Payport need?

Payport requires the following credentials or environment variables: STRIPE_SECRET_KEY. You can find setup instructions on the server detail page.

What AI apps work with Payport?

Payport uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Payport MCP Server

by CloudCorpRecords

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2

Moderate5.2Moderate Risk

payport is a Stripe API wrapper that requires STRIPE_SECRET_KEY, sends it only as a Bearer token to api.stripe.com, and makes no other network calls, with no evidence of exfiltration, obfuscation, or shell execution. The main concerns are that the agent can trigger irreversible financial actions such as refunds, dispute submissions, and subscription cancellations without a confirmation step, and that create operations send no idempotency keys, so retries could duplicate money movements. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

STRIPE_SECRET_KEYRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-cloudcorprecords-payport": {
      "env": {
        "STRIPE_SECRET_KEY": "your-stripe-secret-key-here"
      },
      "args": [
        "-y",
        "@reneturcios/payport"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

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

Or run the container image:

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

export STRIPE_SECRET_KEY="your secret key"

payport create-customer --name "Ada Lovelace" --email ada@example.com
payport list-customers --email ada@example.com --limit 5
payport create-product --name "Trail Guide" --description "A field guide"
payport list-products --limit 10
payport 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:

npx -y @reneturcios/payport mcp

MCP client configuration:

{
  "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

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

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.