MCP Directory

How to add Stripe MCP Server (Agent Toolkit) to Cursor

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 1.9k★ · stdio · apikey · official

Cursor config for Stripe MCP Server (Agent Toolkit)

npx -y @stripe/mcp --tools=all --api-key=<your-stripe-secret-key>
{
  "mcpServers": {
    "stripe-mcp-server-agent-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all",
        "--api-key=<your-stripe-secret-key>"
      ]
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Stripe MCP Server (Agent Toolkit) config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Stripe MCP Server (Agent Toolkit)'s tools to confirm it's connected.

Before you start

  • Node.js 18+ (the local server runs via npx)
  • A Stripe account
  • A Stripe secret key — preferably a Restricted API Key (RAK) with only the permissions the agent needs, created at https://dashboard.stripe.com/apikeys
  • For the remote server (mcp.stripe.com): an MCP client that supports OAuth or bearer-token auth

What Stripe MCP Server (Agent Toolkit) can do in Cursor

create_customer

Create a new customer record.

list_customers

List existing customers.

create_payment_link

Generate a shareable Stripe payment link.

create_product

Create a product in the catalog.

create_price

Create a price for a product.

create_invoice

Create an invoice; pair with create_invoice_item and finalize_invoice.

list_invoices

List invoices for review or reconciliation.

list_subscriptions

List subscriptions; update_subscription and cancel_subscription manage them.

Security

Grants live access to your Stripe account; always use a restricted API key scoped to only the needed resources rather than your full secret key. For agents, prefer the remote server's OAuth flow over embedding keys.

Stripe MCP Server (Agent Toolkit) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Stripe MCP Server (Agent Toolkit) config there under the "mcpServers" key and restart the client.

Is Stripe MCP Server (Agent Toolkit) safe to use with Cursor?

Grants live access to your Stripe account; always use a restricted API key scoped to only the needed resources rather than your full secret key. For agents, prefer the remote server's OAuth flow over embedding keys.

Local server or remote (mcp.stripe.com) — which should I use?

Use the local `@stripe/mcp` server if your client only supports stdio or you want to keep keys on your machine. Use the remote server for OAuth-based, revocable, granular permissions and zero-install setup in clients like Cursor, VS Code, and Claude Code.

How do I limit what the agent can do?

Scope it with a Restricted API Key (RAK) so the server can only call the resources you grant, and/or pass `--tools=` with a specific subset of tool names instead of `--tools=all`.

Does it work with test mode?

Yes. Use a test-mode secret key (sk_test_…) and all calls hit your Stripe test data, so you can build and verify flows without moving real money.

View repo Full Stripe MCP Server (Agent Toolkit) page