PayPal MCP

Integrations

  • Provides integration with PayPal's payment processing, invoicing, and business management features, allowing users to create and manage orders, process payments, handle payment tokens, manage disputes, create and manage products, generate invoices, process payouts, and handle partner referrals.

PayPal MCP Server

Maintained by DynamicEndpoints - Contact: kameron@dynamicendpoints.com

A Model Context Protocol (MCP) server that provides integration with PayPal's APIs. This server enables seamless interaction with PayPal's payment processing, invoicing, and business management features through a standardized interface.

Architecture

Features

  • Payment Processing
    • Create and manage orders
    • Process payments
    • Handle payment tokens
    • Manage disputes
  • Business Operations
    • Create and manage products
    • Generate invoices
    • Process payouts
    • Handle partner referrals
  • User Management
    • Identity verification
    • User information retrieval
    • Web profile management

Installation

Installing via Smithery

To install PayPal MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

  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": [] } } }

Available Tools

Payment Operations

create_payment_token

Create a payment token for future use.

{ customer: { id: string; email_address?: string; }; payment_source: { card?: { name: string; number: string; expiry: string; security_code: string; }; paypal?: { email_address: string; }; }; }
create_order

Create a new order in PayPal.

{ intent: 'CAPTURE' | 'AUTHORIZE'; purchase_units: Array<{ amount: { currency_code: string; value: string; }; description?: string; reference_id?: string; }>; }
create_payment

Create a direct payment.

{ intent: string; payer: { payment_method: string; funding_instruments?: Array<{ credit_card?: { number: string; type: string; expire_month: number; expire_year: number; cvv2: string; first_name: string; last_name: string; }; }>; }; transactions: Array<{ amount: { total: string; currency: string; }; description?: string; }>; }

Business Operations

create_product

Create a new product in the catalog.

{ name: string; description: string; type: 'PHYSICAL' | 'DIGITAL' | 'SERVICE'; category: string; image_url?: string; home_url?: string; }
create_invoice

Generate a new invoice.

{ invoice_number: string; reference: string; currency_code: string; recipient_email: string; items: Array<{ name: string; quantity: string; unit_amount: { currency_code: string; value: string; }; }>; }
create_payout

Process a batch payout.

{ sender_batch_header: { sender_batch_id: string; email_subject?: string; recipient_type?: string; }; items: Array<{ recipient_type: string; amount: { value: string; currency: string; }; receiver: string; note?: string; }>; }

User & Profile Management

get_userinfo

Retrieve user information.

{ access_token: string; }
create_web_profile

Create a web experience profile.

{ name: string; presentation?: { brand_name?: string; logo_image?: string; locale_code?: string; }; input_fields?: { no_shipping?: number; address_override?: number; }; flow_config?: { landing_page_type?: string; bank_txn_pending_url?: string; }; }

Usage Examples

Creating an Order

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

Generating 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: 'Consulting Services', quantity: '1', unit_amount: { currency_code: 'USD', value: '500.00' } }] });

Processing a Payout

const result = await mcpClient.useTool('paypal', 'create_payout', { sender_batch_header: { sender_batch_id: 'Payroll_2024_001', email_subject: 'You have received a payment' }, items: [{ recipient_type: 'EMAIL', amount: { value: '1000.00', currency: 'USD' }, receiver: 'employee@example.com', note: 'Monthly salary payment' }] });

Error Handling

The server implements comprehensive error handling:

  • Input validation errors with detailed messages
  • PayPal API errors with response details
  • Network and authentication errors
  • Rate limiting and timeout handling

Security Considerations

  • All sensitive data is validated and sanitized
  • OAuth 2.0 authentication with PayPal
  • Secure credential management through environment variables
  • Input validation for all API parameters
  • Error messages don't expose sensitive information

Development

Building

npm run build

Testing

npm test

Debugging

The server outputs detailed logs to help with debugging:

  • Authentication issues
  • API call failures
  • Validation errors
  • Request/response details

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License

MIT License

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

This is an MCP server to manage PayPal

  1. Architecture
    1. Features
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
      2. Available Tools
        1. Payment Operations
        2. Business Operations
        3. User & Profile Management
      3. Usage Examples
        1. Creating an Order
        2. Generating an Invoice
        3. Processing a Payout
      4. Error Handling
        1. Security Considerations
          1. Development
            1. Building
            2. Testing
            3. Debugging
          2. Contributing
            1. License

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                An MCP server that provides access to Paylocity API endpoints, allowing retrieval of employee data, earnings, company codes, local taxes, and pay statements.
                Last updated -
                Python
                • Apple
              • -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that provides comprehensive integration with PayPal's APIs, enabling seamless interaction with payment processing, invoicing, subscription management, and business operations through a standardized interface.
                Last updated -
                TypeScript
                Apache 2.0
              • -
                security
                A
                license
                -
                quality
                A server that provides integration with PayPal's APIs, enabling seamless interaction with payment processing, invoicing, subscription management, and business operations through a standardized interface.
                Last updated -
                TypeScript
                MIT License
              • PayPalofficial

                -
                security
                A
                license
                -
                quality
                The PayPal Model Context Protocol server allows you to integrate with PayPal APIs through function calling. This protocol supports various tools to interact with different PayPal services.
                Last updated -
                265
                56
                TypeScript
                Apache 2.0
                • Linux
                • Apple

              View all related MCP servers

              ID: 6op9uaqyev