Stripe MCP

io.github.robinafaruqiaPublished by GitHub account robinafaruqiav0.1.2Updated Oct 24, 2026

Read-only MCP server for querying Stripe customers, payments, and invoices.

The publisher's own server: Stripe

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Read-only Stripe MCP server for querying customers, payments, subscriptions, invoices, and refunds from an AI assistant.

What you can do
Exposes read-only tools for Stripe data: list_customers and get_customer, list_payments and get_payment, list_subscriptions and get_subscription, plus list_invoices and list_refunds. Listing tools accept optional filters such as limit, email, customer_id, status, or payment_intent_id. It is designed to have no charge, refund, update, or delete tools.
When to use it
Useful when you want an assistant to look up Stripe test-mode customers, payment intents, subscriptions, invoices, or refunds while developing or debugging an integration. It is not intended for live account operations or for making changes.
Requirements
Runs locally over stdio, typically via npx @devtechtricks/stripe-mcp, so Node.js is needed. Requires the STRIPE_SECRET_KEY environment variable set to a Stripe test-mode secret or restricted key (sk_test_ or rk_test_); the server refuses to start with live keys. Network access to Stripe is required.
Before you install
The server asks for STRIPE_SECRET_KEY, a Stripe API credential; use a test-mode restricted key with read-only scopes and keep it out of shared configs. It is read-only by design and refuses live keys, so it should not be relied on for any write, refund, or charge action. Queried Stripe data is sent to the configured MCP client and model provider.

Installation

In SourceWeft

  1. Open Stripe MCP in the dashboard and add it to a workspace.
  2. 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

[npm version] [npm downloads] [license] [GitHub stars]

stripe-mcp

A read-only MCP server for querying Stripe — customers, payments, subscriptions, invoices, and refunds.

Use it with any AI or client that supports MCP (Model Context Protocol)—Cursor, Claude Desktop, Claude Code, Windsurf, or other MCP hosts.

Features

  • Read-only by design — no charge, refund, update, or delete tools
  • Test keys only — refuses to start with sk_live_ / rk_live_
  • Single file — just index.js, no build step
  • Works with any MCP client — Cursor, Claude, Windsurf, and others

Cursor plugin

This repo is an Agent Plugin and a Cursor plugin. cursor.directory only detects components committed at the repo root. The files it needs are:

FilePurpose
mcp.jsonMCP server entry (npx -y @devtechtricks/stripe-mcp)
plugin.jsonOpen Plugins manifest
.cursor-plugin/plugin.jsonCursor listing metadata and the STRIPE_SECRET_KEY variable

After these files are on the default branch of the public GitHub repo, submit https://github.com/robinafaruqia/stripe-mcp at cursor.directory/plugins/new. On install, set STRIPE_SECRET_KEY to a Stripe test key (sk_test_... or rk_test_...).

MCP Configuration

Cursor — one-click install

[Add MCP server to Cursor]

After install, replace YOUR_STRIPE_TEST_KEY with a Stripe test secret (sk_test_... or rk_test_...) from the Stripe Dashboard. A restricted key with only read scopes is preferred.

Using npx (recommended)

Add to your MCP client config (e.g. Cursor: ~/.cursor/mcp.json or Settings → MCP; Claude: claude_desktop_config.json; etc.):

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

Claude Code:

bash
claude mcp add stripe-mcp --env STRIPE_SECRET_KEY=sk_test_... -- npx -y @devtechtricks/stripe-mcp

From source (development)

bash
git clone https://github.com/robinafaruqia/stripe-mcp.gitcd stripe-mcpnpm installcp .env.example .env   # then put your sk_test_ / rk_test_ key in .env

Then in your MCP config:

json
{  "mcpServers": {    "stripe-mcp": {      "command": "node",      "args": ["/path/to/stripe-mcp/index.js"]    }  }}

index.js loads .env from the package directory when STRIPE_SECRET_KEY is not already set. npm installs do not include .env — MCP clients should pass the key in env.

Available Tools

ToolDescription
list_customersList recent customers. Optional: limit, email.
get_customerGet a customer by ID. Required: customer_id.
list_paymentsList recent payment intents. Optional: limit, customer_id.
get_paymentGet a payment intent by ID. Required: payment_intent_id.
list_subscriptionsList subscriptions. Optional: limit, customer_id, status.
get_subscriptionGet a subscription by ID. Required: subscription_id.
list_invoicesList invoices. Optional: limit, customer_id, status.
list_refundsList refunds. Optional: limit, payment_intent_id.

Example

1. list_customers({ limit: 5 })2. get_customer({ customer_id: "cus_ABC123" })3. list_subscriptions({ customer_id: "cus_ABC123" })4. list_payments({ limit: 10 })

License

MIT

Source: README.md at commit 936c5de

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% 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

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • 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 listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Stripe integrations