Stripe MCP Server

Official MCP server for the Stripe API. Enables AI agents to interact with Stripe's payment infrastructure including creating and managing customers, payment intents, subscriptions, invoices, and products. Supports reading transaction data, handling refunds, and querying balance information. Useful for building payment integrations, debugging billing issues, and automating financial operations.

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

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Customer full name"
    },
    "email": {
      "type": "string",
      "description": "Customer email address"
    },
    "metadata": {
      "type": "object",
      "description": "Key-value metadata to attach to the customer"
    }
  }
}

{
  "type": "object",
  "required": [
    "amount",
    "currency"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount in smallest currency unit (e.g., cents)"
    },
    "currency": {
      "type": "string",
      "description": "Three-letter ISO currency code (e.g., usd)"
    },
    "customer": {
      "type": "string",
      "description": "Stripe customer ID"
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Number of results to return (max 100)"
    },
    "status": {
      "type": "string",
      "description": "Filter by payment status"
    },
    "customer": {
      "type": "string",
      "description": "Filter by customer ID"
    }
  }
}

{
  "type": "object",
  "required": [
    "payment_intent"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount to refund (partial refund if less than original)"
    },
    "payment_intent": {
      "type": "string",
      "description": "Payment intent ID to refund"
    }
  }
}