PayPal, guarded
PayPal's agent toolkit with refund limits and owner Approve/Deny on risky money actions
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 5 days ago
Similar MCP servers
About PayPal, guarded
PayPal, guarded is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a 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-mcpAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PAYPAL_CLIENT_IDClient ID of your PayPal REST app (developer.paypal.com)RequiredPAYPAL_CLIENT_SECRETSecret of your PayPal REST appRequiredPAYPAL_ENVIRONMENTSANDBOX (default) or PRODUCTIONLIMIT_REFUNDMost per refund without asking you (default 25.00)LIMIT_REFUND_PER_DAYRefunds a day in total (default 100.00)LIMIT_REFUNDS_PER_DAYNumber of refunds a day (default 10)LIMIT_CURRENCYCurrency of the limits (default USD)GUARD_POLICYOther rules as JSON, e.g. {"dispute":"deny","stop":"ask"}FIZZL_AGENT_KEYApprovals in the Fizzl Agent Wallet (Telegram + dashboard): an agent key awk_… from wallet.fizzl.euTELEGRAM_BOT_TOKENApprovals through your own Telegram botTELEGRAM_CHAT_IDYour Telegram chat id (approvals go only there)APPROVAL_IN_CHAToff to never ask in the chat app (MCP elicitation)APPROVAL_MINUTESHow long you have to answer (default 10)
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- paypal_guard_status
- Shows what the guard allows and what it did today.
What it does
- 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
PayPal, guarded 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.
