Home / MCP / PayPal AU Subscription MCP Server

PayPal AU Subscription MCP Server

Provides PayPal Account Updater subscription management with MCP, enabling card freshness updates, subscription queries, and webhook processing.

python

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "paypal_au": {
            "command": "python",
            "args": [
                "-m",
                "fastmcp",
                "run",
                "paypal_au_subscription_mcp.py"
            ],
            "env": {
                "PAYPAL_CLIENT_ID": "YOUR_CLIENT_ID",
                "PAYPAL_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
                "PAYPAL_ENVIRONMENT": "SANDBOX"
            }
        }
    }
}

You can connect your PayPal Account Updater subscription workflow to the MCP protocol, enabling automated card freshness updates, subscription management, and webhook handling within your e-commerce system. This MCP server streamlines subscribing cards, retrieving subscription details, and processing PayPal Account Updater notifications to keep your merchant data up to date.

How to use

To use this MCP server with your MCP client, start the local server that runs the PayPal AU Subscription MCP and point your client to it. You’ll be able to create subscriptions, fetch their details, and handle webhook events that inform you when a card has been updated.

How to install

Prerequisites: Python installed on your system. You will also need an MCP client to interact with the server.

# Clone the subscription MCP server repository
git clone https://github.com/rishabh17081/paypal-au-subscription-connector.git

# Create a Python virtual environment (optional but recommended)
python -m venv venv
source venv/bin/activate  # on Unix/macOS
venv\Scripts\activate     # on Windows

# Install required dependencies
pip install fastmcp requests

Additional sections

Configuration and run details are shown below. Use the exact commands and environment variables shown to start the server and integrate with your MCP client.

Environment variables you must provide when running the server are your PayPal API credentials and environment setting.

When you run the server, you will start the MCP using Python and the FastMCP runtime.

Webhook handling is included. You should configure your PayPal account to send card update notifications to the webhook endpoint implemented by this MCP server.

Usage examples and configuration

Run the MCP server with your PayPal credentials and environment:

# Set environment variables
export PAYPAL_CLIENT_ID="your_client_id"
export PAYPAL_CLIENT_SECRET="your_client_secret"
export PAYPAL_ENVIRONMENT="SANDBOX"  # or "LIVE" or "MOCKDB"

# Run the MCP server
python -m fastmcp run paypal_au_subscription_mcp.py

Claude integration configuration

If you are configuring Claude or a similar MCP client, you can reference the MCP server with the following setup to run the server from your environment.

{
  "mcpServers": {
    "paypal-au": {
      "command": "python",
      "args": ["-m", "fastmcp", "run", "paypal_au_subscription_mcp.py"],
      "env": {
        "PAYPAL_CLIENT_ID": "your_client_id",
        "PAYPAL_CLIENT_SECRET": "your_client_secret",
        "PAYPAL_ENVIRONMENT": "SANDBOX"
      }
    }
  }
}

Available tools

getFreshCardsSolve

Provides information about PayPal Account Updater as a solution for card freshness management.

create_subscription

Create an account status subscription in PayPal.

get_subscription

Get details of an account status subscription in PayPal.

subscribe_merchant_to_paypal_au_service

Provides instructions for subscribing merchant cards to PayPal AU service.

setup_webhook_events_in_merchant_code_base

Sets up webhook event handling code in the merchant's codebase.