Stripe Payments & Billing

Add to your mcp.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp"
      ],
      "env": {
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>"
      }
    }
  }
}

Attach in a FrootAI play (fai-manifest)

mcp_scope:
  attached:
    - stripe

Authentication

create a Restricted API Key (`rk_…`) at dashboard.stripe.com/apikeys with the desired tool permissions, then set STRIPE_SECRET_KEY; use a test-mode key (`rk_test_…`) for development.

Required credential: STRIPE_SECRET_KEY

Environment variables

Sample tools

• stripe.create_customer

  Create a new Stripe customer.

• stripe.list_customers

  List existing customers.

• stripe.create_product

  Create a product in the catalog.

• stripe.create_payment_link

  Create a shareable payment link for a price.

• stripe.create_invoice

  Create an invoice for a customer.

• stripe.search_documentation

  Search Stripe's documentation to answer an integration question.

• stripe.retrieve_balance

  Retrieve the current Stripe account balance.

Used in recipes

FAI cookbook recipes that attach stripe.

• Recipe 30: Notion Doc Update on PR (GitHub + Notion + Stripe)

Destructive-action audit

No destructive tools — audited read-only

Destructive-action audit (X2.18): the server exposes no delete/destroy tools (`destructive_tools` is empty); financial mutations such as refunds still confirm per-call because the trust policy sets `allowDestructive: false` (X1.7 evidence).

Known limitations

• Requires a Stripe API key (STRIPE_SECRET_KEY); without it the server cannot authenticate and every tool returns an auth error.
• Tool availability is bounded by the Restricted API Key's permissions — a read-only key cannot create customers, invoices, or payment links.
• Operates against real Stripe data when given a live key (`sk_live_…` / `rk_live_…`); use a test-mode key for development to avoid real charges.

Spec contributors

Maintainers who landed commits onmcp-specs/stripe.json.

• pspsbali

Freshness

When this spec was last reviewed by a maintainer and last machine-validated against the live server.

Spec last reviewed

1 months ago(2026-06-25)

Auto-validated

never