Paypal MCP Server

🚀 PayPal MCP Server

A Model Context Protocol (MCP) server for PayPal API integration implemented in Python. This server enables Large Language Models (LLMs) to interact with PayPal's APIs through function calls.

🚀 Quick Start

The PayPal MCP Server is a Python - based solution that allows LLMs to communicate with PayPal APIs. It simplifies the process of integrating PayPal services into applications that use LLMs.

✨ Features

• Fully implement the Model Context Protocol (MCP) for PayPal APIs.
• Support all major PayPal API endpoints:
  • Invoices: Create, list, view, send, remind, cancel, generate QR codes.
  • Orders: Create, get, capture.
  • Products: Create, list, view, update.
  • Subscription Plans: Create, list, view.
  • Subscriptions: Create, view, cancel.
  • Shipping Documents: Create, track.
  • Disputes: List, view, accept.
  • Transactions: List and filter.

📦 Installation

From PyPI

pip install paypal-mcp-server

From Source Code

git clone https://github.com/yourusername/paypal-mcp-server.git
cd paypal-mcp-server
pip install -e .

Using Docker

docker pull ghcr.io/yourusername/paypal-mcp-server:latest

💻 Usage Examples

Basic Usage

Command Line

# Use environment variables
export PAYPAL_ACCESS_TOKEN="your access token"
export PAYPAL_ENVIRONMENT="SANDBOX"  # or "PRODUCTION"
paypal-mcp --tools=all

# Or use command - line arguments
paypal-mcp --tools=all --access-token=your access token --paypal-environment=SANDBOX

Enable Specific Tools

paypal-mcp --tools=invoices.create,invoices.list,orders.create --access-token=your token

Using Docker

docker run -e PAYPAL_ACCESS_TOKEN="your access token" -e PAYPAL_ENVIRONMENT="SANDBOX" ghcr.io/yourusername/paypal-mcp-server:latest --tools=all

Advanced Usage

Integration with Claude Desktop

Add the following content to your ~/Claude/claude_desktop_config.json:

{
   "mcpServers": {
     "paypal": {
       "command": "paypal-mcp",
       "args": [
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

Obtain a PayPal Access Token

You can generate a PayPal access token using your client ID and client secret:

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"

🔧 Technical Details

Development

Set up the development environment

# Clone the repository
git clone https://github.com/yourusername/paypal-mcp-server.git
cd paypal-mcp-server

# Install development dependencies
pip install -e ".[dev]"

# Install pre - commit hooks
pre-commit install

Run tests

pytest -xvs

Build the package

python -m build

📄 License

This project is released under the MIT License. See the LICENSE file for details.

Acknowledgments

• Based on PayPal's Agent Toolkit.
• Compatible with the Model Context Protocol specification.