Stripe Integration MCP Server

Finance & FintechPython

Integrate Stripe payment processing capabilities into your AI assistant

Available Tools

customer_create

Create a new customer in Stripe with the provided information

nameemaildescriptionmetadata

customer_retrieve

Retrieve a customer's details from Stripe using their ID

customer_id

customer_update

Update an existing customer's information in Stripe

customer_idnameemaildescriptionmetadata

payment_intent_create

Create a payment intent for processing payments through Stripe

amountcurrencycustomer_iddescriptionmetadata

charge_list

List recent charges processed through Stripe

limit

refund_create

Create a refund for a previous charge in Stripe

charge_idamountreasonmetadata

The Stripe Integration MCP provides a comprehensive interface to Stripe's payment processing platform, allowing AI assistants to manage customers, process payments, and handle refunds. This integration enables secure financial transactions directly through your AI assistant. With detailed audit logging and structured error handling, this MCP ensures all payment operations are traceable and secure. It's designed to simplify the integration of payment capabilities into AI workflows while maintaining compliance with financial processing standards.

Overview

The Stripe Integration MCP allows AI assistants to interact with Stripe's payment processing platform. This server provides tools for managing customers, processing payments, and handling refunds, all with comprehensive audit logging.

Installation

Prerequisites

Python 3.8 or higher
A Stripe account with API keys
MCP SDK 0.1.0 or higher

Installation Steps

Clone the repository:

git clone https://github.com/atharvagupta2003/mcp-stripe.git
cd mcp-stripe

Set up 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 in the root directory with your Stripe API key:
```
STRIPE_API_KEY=your_stripe_secret_key
```

Integration with Claude Desktop

To add the Stripe Integration to Claude Desktop:

Locate your Claude Desktop configuration file:
- Windows: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the server configuration to the mcpServers section:

{
  "mcpServers": {
    "stripe": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-stripe",
        "run",
        "python",
        "-m",
        "src.server"
      ]
    }
  }
}

Replace /path/to/mcp-stripe with the actual path to your cloned repository.

Usage

Once installed, the Stripe Integration MCP provides several tools for managing payments:

Customer Management

Use the customer management tools to create, retrieve, and update customer information in your Stripe account.

Payment Processing

Create payment intents and list charges to process payments securely through Stripe.

Refund Handling

Process refunds for previous charges when needed.

Security Considerations

Keep your Stripe API key secure and never expose it in client-side code
All operations are logged for audit purposes
Use test API keys during development to avoid processing real payments

Troubleshooting

If you encounter issues:

Verify your Stripe API key is correct and has the necessary permissions
Check the server logs for detailed error messages
Ensure your Stripe account is properly configured for the operations you're attempting

For additional help, refer to the Stripe API documentation or open an issue on the GitHub repository.