English Français العربية

Stripe MCP

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Stripe MCP؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @devtechtricks/stripe-mcp
Claude Code 
claude mcp add stripe-mcp -e 'STRIPE_SECRET_KEY=<your stripe_secret_key>' -- npx -y @devtechtricks/stripe-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "stripe-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@devtechtricks/stripe-mcp@0.1.2"
            ],
            "env": {
                "STRIPE_SECRET_KEY": "<your stripe_secret_key>"
            }
        }
    }
}

متغيرات البيئة

  • STRIPE_SECRET_KEY إلزامي سري Stripe test-mode secret or restricted key (sk_test_ or rk_test_)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. stripe-mcp
  2. Features
  3. Cursor plugin
  4. MCP Configuration
  5. Available Tools
  6. Example
  7. License

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

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.

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

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

Claude Code:

claude mcp add stripe-mcp --env STRIPE_SECRET_KEY=sk_test_... -- npx -y @devtechtricks/stripe-mcp
From source (development)
git clone https://github.com/robinafaruqia/stripe-mcp.git
cd stripe-mcp
npm install
cp .env.example .env   # then put your sk_test_ / rk_test_ key in .env

Then in your MCP config:

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

الأسئلة الشائعة

ما هو Stripe MCP؟

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

كيف أثبّت Stripe MCP؟

يعمل على جهازك. في Claude Code: claude mcp add stripe-mcp -e 'STRIPE_SECRET_KEY=<your stripe_secret_key>' -- npx -y @devtechtricks/stripe-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Stripe MCP إلى مفتاح API؟

نعم. يتطلب STRIPE_SECRET_KEY، وتضبطها في إعداداته.

هل Stripe MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Stripe MCP؟

ينشره robinafaruqia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.