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.

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

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

The server implements Stripe API operations, including:

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

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

• refund_create: Create a refund for a charge

• 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

To install Stripe Server for Claude Desktop automatically via Smithery:

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

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

Set up the environment variables in a .env file:

STRIPE_API_KEY=your_stripe_secret_key

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" ] } } } 

uv run src/server.py

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

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

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

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

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

Run the MCP Inspector for interactive testing:

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

1. Update dependencies:

uv compile pyproject.toml 

2. Build package:

uv build 

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

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