paypal_mcp_server

# PayPal MCP Server A Python implementation of a Model Context Protocol (MCP) server for PayPal API integrations. This server enables Large Language Models (LLMs) to interact with PayPal's APIs through function calling. ## Features - Full implementation of the Model Context Protocol for PayPal APIs - Support for all major PayPal API endpoints: - **Invoices**: Create, list, view, send, remind, cancel, QR codes - **Orders**: Create, get, capture - **Products**: Create, list, view, update - **Subscription Plans**: Create, list, view - **Subscriptions**: Create, view, cancel - **Shipments**: Create, track - **Disputes**: List, view, accept - **Transactions**: List and filter ## Installation ### From PyPI ```bash pip install paypal-mcp-server ``` ### From Source ```bash git clone https://github.com/yourusername/paypal-mcp-server.git cd paypal-mcp-server pip install -e . ``` ### Using Docker ```bash docker pull ghcr.io/yourusername/paypal-mcp-server:latest ``` ## Usage ### Command Line ```bash # Using environment variables export PAYPAL_ACCESS_TOKEN="your_access_token" export PAYPAL_ENVIRONMENT="SANDBOX" # or "PRODUCTION" paypal-mcp --tools=all # Or with command line arguments paypal-mcp --tools=all --access-token=your_access_token --paypal-environment=SANDBOX ``` ### Enable Specific Tools Only ```bash paypal-mcp --tools=invoices.create,invoices.list,orders.create --access-token=your_token ``` ### With Docker ```bash docker run -e PAYPAL_ACCESS_TOKEN="your_access_token" -e PAYPAL_ENVIRONMENT="SANDBOX" ghcr.io/yourusername/paypal-mcp-server:latest --tools=all ``` ## Integration with Claude Desktop Add the following to your `~/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "paypal": { "command": "paypal-mcp", "args": [ "--tools=all" ], "env": { "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN", "PAYPAL_ENVIRONMENT": "SANDBOX" } } } } ``` ## Obtaining a PayPal Access Token You can generate a PayPal access token using your client ID and client secret: ```bash curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \ -H "Accept: application/json" \ -H "Accept-Language: en_US" \ -u "CLIENT_ID:CLIENT_SECRET" \ -d "grant_type=client_credentials" ``` ## Development ### Setup Development Environment ```bash # Clone the repository git clone https://github.com/yourusername/paypal-mcp-server.git cd paypal-mcp-server # Install dev dependencies pip install -e ".[dev]" # Install pre-commit hooks pre-commit install ``` ### Running Tests ```bash pytest -xvs ``` ### Building the Package ```bash python -m build ``` ## License This project is licensed under the MIT License - see the LICENSE file for details. ## Acknowledgments - Based on PayPal's [Agent Toolkit](https://github.com/paypal/agent-toolkit) - Compatible with the [Model Context Protocol](https://modelcontextprotocol.com/) specification