PayPal

Generates standardized tool schemas from PayPal API operations and registers them with 7+ AI frameworks (OpenAI, LangChain, Anthropic, Bedrock, Vercel AI SDK, CrewAI) through framework-specific adapters. Uses a hub-and-spoke architecture where a shared core PayPal operation layer delegates to framework-specific modules that translate PayPal tools into each framework's native function-calling format (OpenAI's tool_choice, LangChain's BaseTool, Anthropic's tool_use_block_delta, etc.), enabling single-codebase deployment across heterogeneous AI stacks.

Exposes PayPal operations as an MCP server that implements the Model Context Protocol specification, allowing any MCP-compatible client (Claude, custom agents, IDE extensions) to discover and invoke PayPal tools via standardized JSON-RPC 2.0 messaging. The MCP server wraps the shared PayPal core layer and translates tool invocations into PayPal REST API calls, handling authentication, error serialization, and response formatting according to MCP resource/tool semantics.

Implements consistent error handling and response parsing in the shared core layer that translates PayPal REST API responses (including error codes, validation failures, rate limiting) into framework-agnostic error objects. Each framework adapter wraps core errors in framework-specific exception types (OpenAI's APIError, LangChain's ToolException, etc.) while preserving PayPal error details. Supports automatic retry logic for transient failures (rate limits, timeouts) and provides detailed error context for debugging.

Provides 7 distinct invoice operations (create, send, update, cancel, search, get details, record payment) that map to PayPal's Invoice REST API endpoints. Each operation is implemented as a typed function in the shared core layer that handles request validation, API authentication, and response parsing. Supports invoice templates, payment tracking, and status transitions (draft, sent, paid, cancelled) with full parameter mapping to PayPal's invoice schema.

Implements 5 order and payment operations (create order, capture payment, authorize payment, refund, get order details) that handle the full payment lifecycle through PayPal's Orders API. Each operation validates input parameters, routes requests to the appropriate PayPal endpoint, and parses responses into typed objects. Supports payment intent selection (CAPTURE vs AUTHORIZE), payer information, and transaction status tracking with error handling for declined payments and authorization failures.

Provides 8 subscription operations and 3 catalog operations for managing recurring billing and product definitions. Subscription operations include create plan, create subscription, update subscription, cancel subscription, suspend subscription, reactivate subscription, and get subscription details. Catalog operations handle product creation, updates, and retrieval. All operations validate parameters against PayPal's subscription schema (billing cycles, pricing tiers, trial periods) and handle subscription state transitions (APPROVAL_PENDING, ACTIVE, SUSPENDED, CANCELLED).

Implements 3 dispute operations (get dispute details, update dispute status, provide evidence) that handle PayPal's dispute resolution workflow. Operations support dispute status tracking (OPEN, UNDER_REVIEW, RESOLVED, ESCALATED), evidence submission with file attachments, and status transitions. The shared core layer validates evidence types (PROOF_OF_DELIVERY, INVOICE, REFUND_CONFIRMATION, etc.) and handles multipart form data for file uploads to PayPal's Disputes API.

Provides 3 shipment operations (add tracking information, update shipment status, get shipment details) that integrate with PayPal's Tracking API for order fulfillment. Operations support carrier selection (USPS, UPS, FedEx, DHL, etc.), tracking number submission, and status transitions (SHIPPED, IN_TRANSIT, DELIVERED, RETURNED). The shared core layer validates carrier codes and tracking formats, enabling agents to automatically update customer shipment status after payment capture.

Implements 2 transaction reporting operations (search transactions, get transaction details) that expose PayPal's Transaction Search API for financial reporting and reconciliation. Operations support filtering by date range, transaction type (PAYMENT, REFUND, ADJUSTMENT, etc.), status, and amount range. The shared core layer handles date formatting, pagination, and response parsing to enable agents to generate financial reports and reconcile transactions with accounting systems.

Implements the entire toolkit in both TypeScript (@paypal/agent-toolkit v1.8.0) and Python (paypal-agent-toolkit v1.8.0) with feature parity and identical APIs. Uses a hub-and-spoke architecture where framework-specific modules (ai-sdk, mcp, langchain, openai, bedrock in TypeScript; openai, langchain, crewai, bedrock in Python) delegate to shared core logic that handles all PayPal API communication, validation, and error handling. This eliminates code duplication and ensures consistent behavior across languages and frameworks.

Provides a PayPalWorkflows class (TypeScript/Vercel AI SDK) that enables orchestration of multi-step payment processes through a workflow abstraction layer. Workflows compose multiple PayPal operations (e.g., create order → authorize payment → add tracking → record invoice) into reusable, chainable sequences with built-in error handling and state management. The workflow layer abstracts framework-specific orchestration (Vercel AI SDK's tool use, LangChain's chains) and provides a unified API for defining payment automation sequences.