Log inSubmit server
Stripe MCP logo

Stripe MCP

Read-only Stripe MCP server for querying customers, payments, subscriptions, invoices, and refunds with test keys.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Stripe MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "stripe-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@devtechtricks/stripe-mcp"
      ],
      "env": {
        "STRIPE_SECRET_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @devtechtricks/stripe-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 5d ago.

Overview

Stripe MCP MCP server exposes read-only Stripe data through Model Context Protocol tools for customers, payments, subscriptions, invoices, and refunds. It runs through npx or directly from the repository and receives a Stripe test secret through STRIPE_SECRET_KEY. Use it when an MCP-compatible client needs to inspect Stripe records without charging, refunding, updating, or deleting data. The server rejects live secret and restricted keys with live prefixes.

Use cases

  • Inspect recent Stripe test customers
  • Review payment intents for a customer
  • Check subscription status from an MCP client
  • Find invoices and refunds in test data

Key features

  • Read-only Stripe data access
  • Customer and payment intent queries
  • Subscription and invoice listing
  • Refund listing by payment intent
  • Test-key enforcement
  • npx and source-based setup

Tools8

What Stripe MCP lets your agent do. Expand a tool for its parameters.

Self-reported~138 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

7/7 checks healthy over the last 53d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @devtechtricks/stripe-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads119Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed8Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Stripe MCP works

What Stripe MCP MCP server does

Stripe MCP MCP server gives MCP-compatible AI clients read access to selected Stripe records. It covers customers, payment intents, subscriptions, invoices, and refunds. The available operations are limited to listing records or retrieving individual customers, payments, and subscriptions by ID.

The server is read-only by design. It does not expose tools for creating charges, issuing refunds, changing records, or deleting data. It also refuses to start when the configured key begins with sk_live_ or rk_live_, so its intended use is Stripe test data.

How it works

An MCP host starts the package as a local process, normally with npx -y @devtechtricks/stripe-mcp. The host supplies the Stripe credential as an environment variable, and the server uses that credential for its read operations. A source checkout can instead run index.js with Node after installing dependencies.

The package uses standard MCP configuration with a command, arguments, and environment values. Cursor, Claude Desktop, Claude Code, Windsurf, and other MCP hosts can register the same server configuration. When running from source, index.js can load a local .env file if STRIPE_SECRET_KEY is not already present; npm installations do not include that file, so installed clients should pass the variable explicitly.

Setup and configuration

Create an MCP entry that runs npx -y @devtechtricks/stripe-mcp, then set STRIPE_SECRET_KEY to a Stripe test secret such as sk_test_... or rk_test_.... The README recommends a restricted key with read scopes where possible. Test keys can be obtained from the test API keys area of the Stripe Dashboard.

For development, clone the repository, run npm install, copy .env.example to .env, and add the test key. The source configuration then points the MCP client at the repository’s index.js with Node. Claude Code can also register the package through its claude mcp add command.

Tools and capabilities

The Stripe MCP MCP server exposes these tools:

  • list_customers: Lists recent customers, optionally filtered by limit and email.
  • get_customer: Retrieves one customer using customer_id.
  • list_payments: Lists recent payment intents, with optional limit and customer_id filters.
  • get_payment: Retrieves one payment intent using payment_intent_id.
  • list_subscriptions: Lists subscriptions, optionally filtered by limit, customer_id, and status.
  • get_subscription: Retrieves one subscription using subscription_id.
  • list_invoices: Lists invoices with optional limit, customer_id, and status filters.
  • list_refunds: Lists refunds, optionally filtered by limit and payment_intent_id.

These tools support workflows such as finding a customer, checking that customer’s subscriptions, reviewing payment intents, or examining refunds associated with a payment intent. Individual invoice retrieval is not listed as an available operation.

Limitations and notes

Only Stripe test keys are supported. The server is intended for inspection rather than account administration, and its tool set does not provide write operations. Keep the secret in the MCP client environment rather than assuming a packaged npm installation will contain a .env file.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Stripe MCP

Stripe MCP is an MCP server that connects AI clients to Stripe test data through read-only tools for listing and retrieving customers, payment intents, subscriptions, invoices, and refunds. It runs through npx or Node and requires the STRIPE_SECRET_KEY environment variable. It does not expose charge, refund, update, or delete operations.

Install it by configuring your MCP client to run `npx -y @devtechtricks/stripe-mcp` and passing a Stripe test key in `STRIPE_SECRET_KEY`. You can also clone the repository, run `npm install`, and point the client at `index.js`.

It requires a Stripe test secret beginning with `sk_test_` or `rk_test_`. The server refuses to start with live-key prefixes `sk_live_` and `rk_live_`. A restricted test key with read scopes is preferred.

Yes, Stripe MCP works with Cursor through its MCP configuration or one-click installation flow. Set `STRIPE_SECRET_KEY` to a Stripe test key after installing, and Cursor starts the package with npx.

You can query customers, payment intents, subscriptions, invoices, and refunds. Customer, payment, and subscription records also have individual lookup tools, while list tools support filters such as customer ID, status, email, payment intent ID, and result limits where documented.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewStripe MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/stripe-mcp?style=directory)](https://allmcps.com/mcp/stripe-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/stripe-mcp"><img src="https://allmcps.com/api/badge/stripe-mcp?style=directory" alt="Stripe MCP on AllMCPs" /></a>