Paypal MCP

🚀 PayPal MCP Server

This is a PayPal MCP server maintained by DynamicEndpoints, which provides a reliable solution for handling PayPal payment - related operations.

🚀 Quick Start

📦 Installation

1. Clone the repository:

git clone https://github.com/your-repository.git
cd your-repository

2. Install dependencies:

npm install

3. Start the server:

node index.js

💻 Usage Examples

Basic Usage

Here are some basic usage examples of the PayPal MCP server:

Create an Order

const result = await mcpClient.useTool('paypal', 'create_order', {
  intent: 'CAPTURE',
  purchase_units: [{
    amount: {
      currency_code: 'USD',
      value: '100.00'
    },
    description: '高级订阅'
  }]
});

Create an Invoice

const result = await mcpClient.useTool('paypal', 'create_invoice', {
  invoice_number: 'INV-2024-001',
  reference: 'REF-2024-001',
  currency_code: 'USD',
  recipient_email: 'customer@example.com',
  items: [{
    name: '咨询服务',
    quantity: '1',
    unit_amount: {
      currency_code: 'USD',
      value: '500.00'
    }
  }]
});

Process a Remittance

const result = await mcpClient.useTool('paypal', 'create_payout', {
  sender_batch_header: {
    sender_batch_id: 'PAY-2024_001',
    email_subject: '您已收到款项'
  },
  items: [{
    recipient_type: 'EMAIL',
    amount: {
      value: '1000.00',
      currency: 'USD'
    },
    receiver: 'employee@example.com',
    note: '月度工资支付'
  }]
});

📚 Documentation

Error Handling

The server implements comprehensive error handling:

• Input validation errors with detailed messages.
• PayPal API errors including response details.
• Network and authentication errors.
• Rate - limit and timeout handling.

Security Precautions

• All sensitive data is verified and sanitized.
• Uses PayPal's OAuth 2.0 authentication.
• Manages security credentials through environment variables.
• Validates all API parameters.
• Error messages do not disclose sensitive information.

Development

Build

npm run build

Test

npm test

Debug

The server outputs detailed logs to assist with debugging:

• Authentication issues.
• Failed API calls.
• Validation errors.
• Request/response details.

Contribution Guidelines

1. Fork the repository:

git clone https://github.com/your-repository.git
cd your-repository

2. Create a feature branch:

git checkout -b feature/your-feature

3. Commit your changes:

git add .
git commit -m '添加新功能'

4. Push to the branch:

git push origin feature/your-feature

5. Create a pull request.

📄 License

This project is under the MIT License.