# PayPal, guarded

> PayPal, guarded is an MCP server for finance and payments. PayPal's agent toolkit with refund limits and owner Approve/Deny on risky money actions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://fizzl-paypal-demo.onrender.com
- **Repository:** https://github.com/fizzl13/x402-examples/tree/HEAD/paypal-guard-mcp
- **MCP Registry name:** io.github.Fizzl13/paypal-guard
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-14

## About

Anything an AI can do with PayPal's own MCP server, it can also do here, since this wrapper exposes the same 47 tools under the same names. The difference is a checking layer between the model and PayPal that reads facts from PayPal itself rather than trusting what the conversation says.

Before a refund the guard looks up the payment and confirms it belongs to the customer being served, that a refund without an amount is limited to what is left, and that no chargeback or dispute is open, since PayPal would otherwise let a second payout through. Default limits are $25 per refund, $100 and 10 refunds per day, one refund per payment per day, and an owner prompt on a customer's third refund within 30 days. Above a limit, and for accepted disputes, price changes or invoices marked as paid, the owner gets Approve or Deny in Telegram, the Fizzl Agent Wallet or the chat app; no answer counts as no.

Blocked calls return a structured reason and tell the model not to find another route. Every non-read action is logged locally with its decision, and daily counts persist across restarts. It needs a PayPal REST app client ID and secret and defaults to the sandbox. A live demo with a support-agent scenario runs in the PayPal sandbox.

## Features

- **Same 47 PayPal tools:** Keeps the tool names of PayPal's own server so existing prompts and --tools lists carry over.
- **Payment ownership check:** Reads the payment at PayPal and compares it with the customer being served.
- **Chargeback awareness:** Stops a refund when an open dispute means the buyer would be paid twice.
- **Daily refund limits:** Defaults of $25 per refund, $100 and 10 refunds a day, set by the owner.
- **Owner approval:** Approve or Deny via Telegram, the Fizzl Agent Wallet or the chat app, with silence meaning no.
- **Local action log:** Records every non-read action with its decision, reasons and approver on your machine.

## Good for

- Let a support agent issue refunds without letting it refund the wrong person
- Cap refund volume per day for a small shop
- Require owner approval for dispute decisions and invoice changes
- Rehearse refund flows safely in the PayPal sandbox

## Install

### Claude Code (Terminal)

```sh
claude mcp add paypal-guard --env PAYPAL_CLIENT_ID='<PAYPAL_CLIENT_ID>' --env PAYPAL_CLIENT_SECRET='<PAYPAL_CLIENT_SECRET>' --env FIZZL_AGENT_KEY='<FIZZL_AGENT_KEY>' --env TELEGRAM_BOT_TOKEN='<TELEGRAM_BOT_TOKEN>' -- npx -y fizzl-paypal-guard-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "paypal-guard": {
      "command": "npx",
      "args": [
        "-y",
        "fizzl-paypal-guard-mcp"
      ],
      "env": {
        "PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
        "PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
        "FIZZL_AGENT_KEY": "<FIZZL_AGENT_KEY>",
        "TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "paypal-guard": {
      "command": "npx",
      "args": [
        "-y",
        "fizzl-paypal-guard-mcp"
      ],
      "env": {
        "PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
        "PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
        "FIZZL_AGENT_KEY": "<FIZZL_AGENT_KEY>",
        "TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "paypal-guard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fizzl-paypal-guard-mcp"
      ],
      "env": {
        "PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
        "PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
        "FIZZL_AGENT_KEY": "<FIZZL_AGENT_KEY>",
        "TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "paypal-guard": {
      "command": "npx",
      "args": [
        "-y",
        "fizzl-paypal-guard-mcp"
      ],
      "env": {
        "PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
        "PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
        "FIZZL_AGENT_KEY": "<FIZZL_AGENT_KEY>",
        "TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "paypal-guard": {
      "command": "npx",
      "args": [
        "-y",
        "fizzl-paypal-guard-mcp"
      ],
      "env": {
        "PAYPAL_CLIENT_ID": "<PAYPAL_CLIENT_ID>",
        "PAYPAL_CLIENT_SECRET": "<PAYPAL_CLIENT_SECRET>",
        "FIZZL_AGENT_KEY": "<FIZZL_AGENT_KEY>",
        "TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
      }
    }
  }
}
```

## Tools

- `paypal_guard_status`: Shows what the guard allows and what it did today.

## FAQ

### Which credentials does it need?

A PayPal REST app client ID and secret, plus PAYPAL_ENVIRONMENT set to SANDBOX (the default) or PRODUCTION. It does not take PayPal's short-lived access token.

### What happens when the guard blocks a call?

It returns blocked: true with the reasons and a message telling the model not to try another way.

### Can the model talk its way past the guard?

The README says the checks use facts from PayPal and limits from the owner, never what the conversation says.

### How do I install it for Claude Desktop?

Add an npx entry for fizzl-paypal-guard-mcp or open the .mcpb file, which asks for credentials and limits.

### How do I add PayPal, guarded to Claude Code?

Run this command in your terminal: claude mcp add paypal-guard --env PAYPAL_CLIENT_ID='<PAYPAL_CLIENT_ID>' --env PAYPAL_CLIENT_SECRET='<PAYPAL_CLIENT_SECRET>' --env FIZZL_AGENT_KEY='<FIZZL_AGENT_KEY>' --env TELEGRAM_BOT_TOKEN='<TELEGRAM_BOT_TOKEN>' -- npx -y fizzl-paypal-guard-mcp

### What are the best alternatives to PayPal, guarded?

The closest alternatives to PayPal, guarded are SafePay Check, PayStage, Agentpay Sentinel MCP, Saifuban and VouchSafe.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [SafePay Check](https://ai-powered.com/mcp/safepay-check): SafePay Check is a freemium MCP server for finance and payments.
- [PayStage](https://ai-powered.com/mcp/paystage-2): PayStage is an open-source MCP server for security.
- [Agentpay Sentinel MCP](https://ai-powered.com/mcp/agentpay-sentinel-mcp): Agentpay Sentinel MCP is a freemium MCP server for finance and payments.
- [Saifuban](https://ai-powered.com/mcp/saifuban): Saifuban is a free MCP server for finance and payments.
- [VouchSafe](https://ai-powered.com/mcp/vouchsafe): VouchSafe is a freemium MCP server for security.
- [MoneyTools Approval Relay](https://ai-powered.com/mcp/moneytools-approval-relay): MoneyTools Approval Relay is a freemium MCP server for security.
- [Pink Agentic AI Payments](https://ai-powered.com/mcp/pink-agentic-ai-payments): Pink Agentic AI Payments is a freemium MCP server for finance and payments.
- [Frisk](https://ai-powered.com/mcp/frisk): Frisk is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/paypal-guarded
