What is the PayPal Agent Toolkit?

The PayPal Agent Toolkit enables popular agent frameworks, including OpenAI’s Agent SDK and LangChain, to integrate with PayPal APIs through function calling. It supports TypeScript and is built on top of PayPal APIs and SDKs.

What tools are available in the PayPal Agent Toolkit?

The toolkit provides tools for invoices (create, list, get, send, cancel), payments (create and get orders, pay order), dispute management (list, get, accept claims), shipment tracking (create, get), catalog management (create, list, show product details), subscription management (create, list, show plan details, cancel), and reporting (list transactions).

How do I install the PayPal Agent Toolkit?

If you only want to use the package, run npm install @paypal/agent-toolkit. Node 18+ is required.

How do I configure the PayPal Agent Toolkit?

You need your account’s client ID and secret, which are available in your PayPal Developer Dashboard. Then, initialize the toolkit with these credentials.

What is the PayPal Model Context Protocol (MCP)?

The PayPal Model Context Protocol (MCP) server allows you to integrate with PayPal APIs through function calling. It supports various tools to interact with different PayPal services.

How do I run the PayPal MCP server?

Use the command: npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX". Replace YOUR_ACCESS_TOKEN with an active access token.

How do I integrate the PayPal connector with Claude Desktop?

1. Install Node.js (18+).
2. Add the PayPal connector configuration to ~/Claude/claude_desktop_config.json.
3. Restart Claude Desktop.
4. Test the connection by asking Claude to perform a PayPal-related task.

What environment variables are used?

The following environment variables can be used:

• PAYPAL_ACCESS_TOKEN: Your PayPal Access Token
• PAYPAL_ENVIRONMENT: Set to SANDBOX for sandbox mode, PRODUCTION for production (defaults to SANDBOX mode)

How do I find my Client ID and Client Secret?

1. Go to the PayPal Developer Dashboard.
2. Click on Apps & Credentials.
3. Create or select an app to view your Client ID and Client Secret.

How do I generate an Access Token?

Using cURL:

bash curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token
-H “Accept: application/json”
-H “Accept-Language: en_US”
-u “CLIENT_ID:CLIENT_SECRET”
-d “grant_type=client_credentials”

Replace CLIENT_ID and CLIENT_SECRET with your credentials.

How long are PayPal access tokens valid?

Sandbox tokens are valid for 3-8 hours, while production tokens are valid for 8 hours. It’s recommended to implement token refresh logic.

What is UBOS?

UBOS is a Full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. The platform helps orchestrate AI Agents, connect them with enterprise data, build custom AI Agents with your LLM model, and create Multi-Agent Systems.