MCP Stripe

by atharvagupta2003

1 forks

12 stars

Free

What is mcp-stripe

mcp-stripe is a Model Context Protocol (MCP) server implementation developed by atharvagupta2003, designed to seamlessly integrate with Stripe for managing financial transactions. This server provides a secure and structured API to handle payments, customers, and refunds, making it a powerful tool for businesses that need reliable transaction management. By using mcp-stripe, developers can ensure that their applications can securely interact with Stripe's payment processing capabilities while benefiting from MCP's robust integration framework.

How to Use mcp-stripe

To get started with mcp-stripe, you need to set up your environment with a few prerequisites. Ensure you have Python 3.8 or higher, the MCP SDK 0.1.0 or above, the Stripe Python SDK, and dotenv for environment variable management.

Installation and Setup

Create a Virtual Environment:

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows

Install Dependencies:
```
pip install -e .
```
Configure Environment Variables: Create a .env file and set your Stripe API key:
```
STRIPE_API_KEY=your_stripe_secret_key
```
Start the Server:
```
uv run src/server.py
```

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

Key Features of mcp-stripe

Secure Payments: Leverages Stripe's robust payment processing capabilities to ensure secure and reliable financial transactions.
Audit Logging: Provides comprehensive logging of all operations related to customers, payments, and refunds, facilitating better traceability and accountability.
Error Handling: Offers clear and detailed error messages for common issues, such as missing API keys or invalid parameters, helping users quickly diagnose and resolve problems.
MCP Integration: Fully compatible with MCP tools and resource listings, enabling seamless interaction with AI clients like Claude.
Customer and Payment Management: Simplifies customer management and payment processing through intuitive API operations, such as creating and updating customer details, managing payment intents, and processing refunds.

mcp-stripe is designed to be a user-friendly solution for developers looking to integrate Stripe payments into their applications while maintaining a secure and auditable environment.

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

stripe_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

To install Stripe Server for Claude Desktop automatically via :

npx -y @/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\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

Update dependencies:

uv compile pyproject.toml

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.

How to Use

To use the mcp-stripe, follow these steps:

Visit https://github.com/atharvagupta2003/mcp-stripehttps://github.com/atharv...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using mcp-stripe capabilities within your Claude conversations

Additional Information

Created

March 12, 2025

Company

atharvagupta2003

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More