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

pip install paypal-mcp-server

From Source

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

Command Line

# 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

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

With Docker

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:

{
   "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:

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

# 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

pytest -xvs

Building the Package

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
• Compatible with the Model Context Protocol specification