PayPal

You can connect your application to PayPal using a dedicated MCP (Model Context Protocol) server that acts as a bridge to PayPal’s payment processing, invoicing, payouts, and business management APIs. This server handles authentication, input validation, and API calls, letting you focus on your client experience and workflows.

How to use

Install and run the PayPal MCP Server in your environment, then connect your MCP client to it. Use the MCP client to create orders, process payments, generate invoices, and manage products, payouts, and user profiles through PayPal APIs. The server handles OAuth authentication with PayPal, input validation, and error handling, returning structured results you can display or further process in your application.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install via Smithery to automatically wire the PayPal MCP Server into Claude Desktop:

npx -y @smithery/cli install @DynamicEndpoints/Paypal-MCP --client claude

Manual installation steps you can run locally:

1. Clone the repository
2. Install dependencies:
   npm install
3. Build the project:
   npm run build
4. Configure PayPal credentials in the MCP settings file:

{ "mcpServers": { "paypal": { "command": "node", "args": ["path/to/paypal-server/build/index.js"], "env": { "PAYPAL_CLIENT_ID": "your_client_id", "PAYPAL_CLIENT_SECRET": "your_client_secret" }, "disabled": false, "autoApprove": [] } } }

## Configuration and security notes

The PayPal MCP Server runs locally as a stdio-based MCP service. It uses OAuth 2.0 to obtain access tokens from PayPal and securely stores credentials via environment variables. Ensure you keep client secrets out of your codebase and load them from a secure environment manager.

The server validates all inputs to prevent invalid API calls and potential misuse. Error responses include validation issues, PayPal API errors, and network/authentication problems, without exposing sensitive information.

## Usage patterns and examples

Establish the PayPal MCP Server as a local service using the provided startup command, then interact with it via your MCP client to perform common workflows such as creating orders, processing payments, generating invoices, and issuing payouts. Use the same client to retrieve user information and to manage web profiles for a cohesive PayPal integration.

## Development and troubleshooting

Build and test locally by running the following commands to verify compilation and test coverage, then start the server and observe logs for authentication issues, API call failures, or validation errors.

npm run build npm test

## Available tools

### create\_payment\_token

Create a payment token for future use, including customer and payment source details.

### create\_order

Create a new PayPal order with specified purchase units and amounts.

### create\_payment

Create a direct payment using specified payer information and transactions.

### create\_product

Create a new product in the catalog with name, description, type, and category.

### create\_invoice

Generate a new invoice with items and recipient details.

### create\_payout

Process a batch payout with sender batch header and payout items.

### get\_userinfo

Retrieve user information using an access token.

### create\_web\_profile

Create a web experience profile for customized checkout experiences.