What is Paypal Mcp Server

paypal_mcp_server is an Un-Official PayPal MCP Server Example designed for private testing purposes. It is a Python implementation of a Model Context Protocol (MCP) server that allows Large Language Models (LLMs) to interact with PayPal’s APIs through function calling.

Use cases

Use cases for paypal_mcp_server include automating invoice creation and management, processing orders, managing subscription services, tracking shipments, handling disputes, and analyzing transaction data.

How to use

To use paypal_mcp_server, you can install it via PyPI or from source. You can run it from the command line by setting environment variables for your PayPal access token and environment, or by using Docker. Specific tools can be enabled by specifying them in the command.

Key features

Key features include full implementation of the Model Context Protocol for PayPal APIs, support for major PayPal API endpoints such as Invoices, Orders, Products, Subscription Plans, Subscriptions, Shipments, Disputes, and Transactions.

Where to use

paypal_mcp_server can be used in various fields that require integration with PayPal’s APIs, such as e-commerce, financial services, and software development for payment processing.

Un-Official 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