Stripe

🚀 MCP Stripe Server

An implementation of the Model Context Protocol (MCP) server integrated with Stripe for handling payments, customers, and refunds. This server provides a structured API to securely manage financial transactions.

🚀 Quick Start

The MCP Stripe Server is an essential tool for securely managing financial transactions. It integrates with Stripe to handle payments, customers, and refunds, and provides a structured API for these operations.

✨ Features

• Secure Payments: Integrates with Stripe for robust payment processing.
• Audit Logs: Records all Stripe transactions.
• Error Handling: Comprehensive error handling with clear messages.
• MCP Integration: Supports MCP-compatible tools and resource lists.

📦 Installation

Install via Smithery

Automatically install the Stripe server for Claude Desktop through Smithery:

npx -y @smithery/cli install @atharvagupta2003/mcp-stripe --client claude

Install Dependencies

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
pip install -e .

Configuration

Set environment variables in the .env file:

STRIPE_API_KEY=your_stripe_secret_key

Claude Desktop

Add the server configuration to your Claude Desktop configuration:

• Windows: C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json
• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src",
        "run",
        "server.py"
      ]
    }
  }
}

💻 Usage Examples

Start the Server

uv run src/server.py

MCP Example Commands

Create a Customer

{
    "tool": "customer_create",
    "arguments": {
        "email": "customer@example.com",
        "name": "John Doe"
    }
}

Retrieve a Customer

{
    "tool": "customer_retrieve",
    "arguments": {}
}

Update a Customer

{
    "tool": "customer_update",
    "arguments": {
        "id": "customer_id",
        "email": "new_email@example.com"
    }
}

Create a Payment Intent

uv payment_intent_create --amount 100 --currency usd

List Charges

uv charge_list

Create a Refund

{
    "tool": "refund_create",
    "arguments": {
        "charge_id": "charge_123"
    }
}

📚 Documentation

Demo

Requirements

• Python 3.8+
• MCP SDK 0.1.0+
• Stripe Python SDK
• dotenv

Components

Resources

The server provides audit log recording for all Stripe operations:

• Stores audit logs for customer, payment, and refund operations.
• Supports structured logs for improved traceability.
• Uses MCP resource endpoints to retrieve audit data.

Tools

The server implements Stripe API operations, including:

Customer Management

• customer_create: Create a new customer.
• customer_retrieve: Retrieve customer details.
• customer_update: Update customer information.

Payment Operations

• payment_intent_create: Create a payment intent for processing payments.
• charge_list: List recent charges.

Refund Operations

• refund_create: Create a refund for a charge.

🔧 Technical Details

• Security: Integrates with Stripe for secure payment processing.
• Logging: Records all Stripe transactions for auditing.
• Error Handling: Comprehensive error handling with clear messages.
• MCP Integration: Supports MCP-compatible tools and resource lists.

📄 License

All rights reserved. Unauthorized reproduction or distribution is prohibited.