MCP Stripe Server

Demo

Requirements

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

Components

Resources

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

Tools

Customer Management

• customer_create: Create a new customer
• customer_retrieve: Retrieve a customer's 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

Features

• Secure Payments: Integrates with Stripe for robust payment handling
• Audit Logging: Keeps track of all Stripe transactions
• Error Handling: Comprehensive error handling with clear messages
• MCP Integration: Supports MCP-compatible tools and resource listing

Installation

Installing via 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

.env

STRIPE_API_KEY=your_stripe_secret_key

Claude Desktop

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

Usage

Start the server

uv run src/server.py

Example MCP Commands

Create a customer

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

Retrieve a customer

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

Create a payment intent

{
    "tool": "payment_intent_create",
    "arguments": {
        "amount": 5000,
        "currency": "usd",
        "customer": "cus_123456"
    }
}

Create a refund

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

Error Handling

• Missing API Key: STRIPE_API_KEY required
• Invalid API Key: Authentication error
• Customer not found: Invalid customer ID
• Invalid input: Missing or incorrect parameters

Development

Testing

npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src run server.py

Building

1. Update dependencies:

uv compile pyproject.toml

1. Build package:

uv build

Contributing

License