MCP Stripe Server

What is MCP Stripe Server about?

MCP Stripe Server offers a ready‑to‑run MCP‑compatible backend that connects to the Stripe API. It exposes tools for creating and retrieving customers, generating payment intents, listing charges, and issuing refunds. All operations are logged for auditability.

How to use MCP Stripe Server?

1. Install the package (e.g., via Smithery):

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

2. Set up environment by creating a .env file with your Stripe secret key:

   STRIPE_API_KEY=your_stripe_secret_key
   

3. Start the server:

   uv run src/server.py
   

4. Interact using MCP commands such as customer_create, payment_intent_create, or refund_create in a compatible client (e.g., Claude Desktop).

Key features of MCP Stripe Server

• Secure integration with Stripe for payment processing
• Comprehensive customer management (create, retrieve, update)
• Payment intent creation and charge listing
• Refund creation for any charge
• Structured audit logging of all Stripe operations
• Detailed error messages for missing keys, authentication failures, and invalid inputs
• MCP‑compatible tools and resource endpoints for easy consumption

Use cases of MCP Stripe Server

• Building e‑commerce platforms that need a simple payment backend
• Automating subscription billing workflows
• Auditable financial transaction tracking for compliance
• Rapid prototyping of payment features within AI‑driven applications
• Integrating refunds and charge management into internal admin tools

FAQ from the MCP Stripe Server

Q: What Python version is required? A: Python 3.8 or newer.

Q: Which libraries must be installed? A: MCP SDK (≥0.1.0), Stripe Python SDK, and python-dotenv.

Q: How are audit logs accessed? A: Through MCP resource endpoints provided by the server; logs are stored in a structured format.

Q: What if the STRIPE_API_KEY is missing? A: The server will return a clear error indicating that the API key is required.

Q: Can I run the server on Windows? A: Yes. Activate the virtual environment with venv\Scripts\activate and then start the server as shown above.

MCP Stripe Server

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

Demo

Requirements

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

Components

Resources

The server provides audit logging of all Stripe operations:

• Stores audit logs of customer, payment, and refund operations
• Supports structured logging for better 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 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

To install Stripe Server for Claude Desktop automatically 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

Set up the environment variables in a .env file:

STRIPE_API_KEY=your_stripe_secret_key

Claude Desktop

Add the server configuration to your Claude Desktop config:

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

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

The server provides clear error messages for common scenarios:

• 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

Run the MCP Inspector for interactive testing:

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

Building

1. Update dependencies:

uv compile pyproject.toml

2. Build package:

uv build

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.