Stripe

What is mcp-stripe?

mcp-stripe is a Model Context Protocol (MCP) server that integrates with Stripe to manage financial transactions securely. It provides a structured API for handling payments, customers, and refunds, and includes audit logging for all Stripe operations.

How to use mcp-stripe?

To use mcp-stripe, you can install it via Smithery for Claude Desktop or manually. After installation, configure your environment variables with your Stripe API key and add the server configuration to your Claude Desktop settings. You can then start the server and use example MCP commands to create customers, retrieve customer details, create payment intents, and create refunds.

Key Features of mcp-stripe

• Secure Payments: Integrates with Stripe for robust payment handling.
• Audit Logging: Keeps track of all Stripe transactions, including customer, payment, and refund operations, with structured logging for traceability.
• Error Handling: Provides comprehensive error handling with clear messages for common scenarios like missing API keys or invalid input.
• MCP Integration: Supports MCP-compatible tools and resource listing.
• Customer Management: Tools for creating, retrieving, and updating customer information.
• Payment Operations: Tools for creating payment intents and listing recent charges.
• Refund Operations: Tool for creating refunds for charges.

Use Cases of mcp-stripe

mcp-stripe can be used in scenarios where you need to:

• Integrate Stripe payment processing into an application.
• Manage customer information within a Stripe-integrated system.
• Automate payment and refund operations.
• Maintain an audit trail of all financial transactions for compliance and monitoring.

FAQ from mcp-stripe

Q: What are the requirements to run mcp-stripe? A: You need Python 3.8+, MCP SDK 0.1.0+, Stripe Python SDK, and dotenv.

Q: How do I configure my Stripe API key? A: Set the STRIPE_API_KEY environment variable in a .env file.

Q: How do I handle errors? A: The server provides clear error messages for issues like missing API keys, invalid API keys, customer not found, or invalid input.

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.