MCP Stripe Server

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:\n\n#### Customer Management

• customer_create: Create a new customer
• customer_retrieve: Retrieve a customer's details
• customer_update: Update customer information\n\n#### Payment Operations
• payment_intent_create: Create a payment intent for processing payments
• charge_list: List recent charges\n\n#### 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
```\n\n### Install dependencies
```sh
python -m venv venv
source venv/bin/activate # On macOS/Linux
venv\Scripts\activate # On Windows
pip install -e .
```\n\n### Configuration
Set up the environment variables in a `.env` file:
```sh
STRIPE_API_KEY=your_stripe_secret_key
```\n\n#### 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
```json
{
  "mcpServers": {
    "stripe": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src", "run", "server.py"]
    }
  }
}
```\n\n## Usage# Start the server
```sh
uv run src/server.py
```\n\n### Example MCP Commands## Create a customer
```json
{
  "tool": "customer_create",
  "arguments": {
    "email": "[email protected]",
    "name": "John Doe"
  }
}
```\n\n#### Retrieve a customer
```json
{
  "tool": "customer_retrieve",
  "arguments": {
    "customer_id": "cus_123456"
  }
}
```\n\n#### Create a payment intent
```json
{
  "tool": "payment_intent_create",
  "arguments": {
    "amount": 5000,
    "currency": "usd",
    "customer": "cus_123456"
  }
}
```\n\n#### Create a refund
```json
{
  "tool": "refund_create",
  "arguments": {
    "charge_id": "ch_abc123"
  }
}
```\n\n## 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\n\n## Development# Testing
Run the MCP Inspector for interactive testing:
```sh
npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src run server.py
```\n\n### Building
1. Update dependencies:
```sh
uv compile pyproject.toml

2. Build package:

uv build
```\n\n### Contributing
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.