PayPal Agent Toolkit vs Stripe Agent Toolkit

PayPal Agent Toolkit

The PayPal Agent Toolkit enables popular agent frameworks including OpenAI's Agent SDK, LangChain, Vercel's AI SDK, and Model Context Protocol (MCP) to integrate with PayPal APIs through function calling. It includes support for TypeScript and is built on top of PayPal APIs and the PayPal SDKs.

Available tools

The PayPal Agent toolkit provides the following tools:

Invoices

• create_invoice: Create a new invoice in the PayPal system, including recipient billing details, line items, an invoice note, a custom color theme, an optional shipping cost, and an option to enable PAY_BY_BANK as a payment method

• list_invoices: List invoices with optional pagination and filtering

• get_invoice: Retrieve details of a specific invoice

• send_invoice: Send an invoice to recipients

• send_invoice_reminder: Send a reminder for an existing invoice

• cancel_sent_invoice: Cancel a sent invoice

• generate_invoice_qr_code: Generate a QR code for an invoice

• delete_invoice: Permanently delete a draft or scheduled invoice

• generate_invoice_number: Generate the next invoice number available to the merchant

• search_invoicing: Search for invoices or recurring invoice series

• update_invoicing: Update an existing invoice or recurring invoice series (full-replacement)

• cancel_invoice_auto_reminder: Cancel all scheduled automatic reminders for an invoice

• record_payment_for_invoice: Record an external or manual payment against an invoice

• record_refund_for_invoice: Record a refund against an invoice

• create_conditional_rules_for_invoice: Create conditional rules for an invoice, such as an early payment discount or automatic cancellation date

• create_recurring_series: Create a recurring invoice series that automatically generates and sends invoices on a schedule

• activate_recurring_series: Activate a draft recurring invoice series

• get_recurring_series: Retrieve details of a specific recurring invoice series

• cancel_recurring_series: Cancel an active recurring invoice series

• delete_recurring_series: Delete a draft recurring invoice series

Payments

• create_order: Create an order in PayPal system based on provided details
• get_order: Retrieve the details of an order
• pay_order: Process payment for an authorized order
• create_refund: Process a refund for a captured payment.
• get_refund: Get the details for a specific refund.

Dispute Management

• list_disputes: Retrieve a summary of all open disputes
• get_dispute: Retrieve detailed information of a specific dispute
• accept_dispute_claim: Accept a dispute claim

Shipment Tracking

• create_shipment_tracking: Create a shipment tracking record
• get_shipment_tracking: Retrieve shipment tracking information
• update_shipment_tracking: Update shipment tracking information

Catalog Management

• create_product: Create a new product in the PayPal catalog
• list_products: List products with optional pagination and filtering
• show_product_details: Retrieve details of a specific product

Subscription Management

• create_subscription_plan: Create a new subscription plan
• list_subscription_plans: List subscription plans
• show_subscription_plan_details: Retrieve details of a specific subscription plan
• create_subscription: Create a new subscription
• show_subscription_details: Retrieve details of a specific subscription
• update_subscription: update an existing subscription
• cancel_subscription: Cancel an active subscription

Reporting and Insights

• list_transactions: List transactions with optional pagination and filtering
• get_merchant_insights: Retrieve business intelligence metrics and analytics for a merchant

TypeScript

Installation

You don't need this source code unless you want to modify the package. If you just
want to use the package run:

npm install @paypal/agent-toolkit

Requirements

• Node 18+

Usage

The library needs to be configured with your account's client id and secret which is available in your PayPal Developer Dashboard.

The toolkit works with Vercel's AI SDK and can be passed as a list of tools. For more details, refer our examples

import { PayPalAgentToolkit } from '@paypal/agent-toolkit/ai-sdk';
const paypalToolkit = new PayPalAgentToolkit({
  clientId: process.env.PAYPAL_CLIENT_ID,
  clientSecret: process.env.PAYPAL_CLIENT_SECRET,
  configuration: {
    actions: {
      invoices: {
        create: true,
        createRecurringSeries: true,
        list: true,
        send: true,
        sendReminder: true,
        cancel: true,
        delete: true,
        generateQRC: true,
        generateInvoiceNumber: true,
        search: true,
        update: true,
        cancelReminders: true,
        recordPayment: true,
        recordRefund: true,
        createConditionalRules: true,
      },
      products: { create: true, list: true, update: true },
      subscriptionPlans: { create: true, list: true, show: true },
      shipment: { create: true, show: true, cancel: true },
      orders: { create: true, get: true },
      disputes: { list: true, get: true },
    },
  },
});

To use sandbox mode, add context within your configuration.

configuration: {
  context: {
    sandbox: true,
  }
}

Initializing the Workflows

import { PayPalWorkflows, ALL_TOOLS_ENABLED } from '@paypal/agent-toolkit/ai-sdk';
const paypalWorkflows = new PayPalWorkflows({
  clientId: process.env.PAYPAL_CLIENT_ID,
  clientSecret: process.env.PAYPAL_CLIENT_SECRET,
  configuration: {
    actions: ALL_TOOLS_ENABLED,
  },
});

Usage

Using the toolkit

const llm: LanguageModelV1 = getModel(); // The model to be used with ai-sdk
const { text: response } = await generateText({
  model: llm,
  tools: paypalToolkit.getTools(),
  maxSteps: 10,
  prompt: `Create an order for $50 for custom handcrafted item and get the payment link.`,
});

Environment Variables

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)

This guide explains how to generate an access token for PayPal API integration, including how to find your client ID and client secret.

Prerequisites

• PayPal Developer account (for Sandbox)
• PayPal Business account (for production)

Finding Your Client ID and Client Secret

1. Create a PayPal Developer Account:

   • Go to PayPal Developer Dashboard
   • Sign up or log in with your PayPal credentials

2. Access Your Credentials:

   • In the Developer Dashboard, click on Apps & Credentials in the menu
   • Switch between Sandbox and Live modes depending on your needs

3. Create or View an App:

   • To create a new app, click Create App
   • Give your app a name and select a Business account to associate with it
   • For existing apps, click on the app name to view details

4. Retrieve Credentials:

   • Once your app is created or selected, you'll see a screen with your:
     • Client ID: A public identifier for your app
     • Client Secret: A private key (shown after clicking "Show")
   • Save these credentials securely as they are required for generating access tokens

Generating an Access Token

Using cURL

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 actual credentials. For production, use https://api-m.paypal.com instead of the sandbox URL.

Using Postman

1. Create a new request to https://api-m.sandbox.paypal.com/v1/oauth2/token
2. Set method to POST
3. Under Authorization, select Basic Auth and enter your Client ID and Client Secret
4. Under Body, select x-www-form-urlencoded and add a key grant_type with value client_credentials
5. Send the request

Response

A successful response will look like:

{
  "scope": "...",
  "access_token": "Your Access Token",
  "token_type": "Bearer",
  "app_id": "APP-80W284485P519543T",
  "expires_in": 32400,
  "nonce": "..."
}

Copy the access_token value for use in your Claude Desktop integration.

Token Details

• Sandbox Tokens: Valid for 3-8 hours
• Production Tokens: Valid for 8 hours
• It's recommended to implement token refresh logic before expiration

Using the Token with Claude Desktop

Once you have your access token, update the PAYPAL_ACCESS_TOKEN value in your Claude Desktop connector configuration:

{
  "env": {
    "PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN",
    "PAYPAL_ENVIRONMENT": "SANDBOX"
  }
}

Best Practices

1. Store client ID and client secret securely
2. Implement token refresh logic to handle token expiration
3. Use environment-specific tokens (sandbox for testing, production for real transactions)
4. Avoid hardcoding tokens in application code

Disclaimer

AI-generated content may be inaccurate or incomplete. Users are responsible for independently verifying any information before relying on it. PayPal makes no guarantees regarding output accuracy and is not liable for any decisions, actions, or consequences resulting from its use.

Stripe AI

This repository contains Stripe agent plugins and skills, and benchmarks for building AI-powered products and businesses on top of Stripe.

The following packages are deprecated and will receive no further updates, including security fixes:

• @stripe/agent-toolkit and stripe-agent-toolkit: use native MCP support with Stripe MCP.
• @stripe/mcp: connect directly to the hosted Stripe MCP server using native MCP support.
• @stripe/ai-sdk: see the current Stripe Token Billing documentation.
• @stripe/token-meter: see the current Stripe Token Billing documentation.

Existing users with migration questions can contact token-billing-team@stripe.com.

Final package source remains available for reference.

Model Context Protocol (MCP)

Stripe hosts a remote MCP server at https://mcp.stripe.com. This allows secure MCP client access via OAuth. View the docs here.

You can also build autonomous agents with MCP as well.

Agent skills

Agent skills are instructions that agents can use to build faster and more accurately. Stripe offers a collection of skills that help your agents use the latest best practices when building with Stripe.

If you use one of these popular agent harnesses, we recommend installing the official Stripe plugins, which include additional agent tools and update automatically.

Claude Code

Run this command in your project:

claude plugin install stripe@claude-plugins-official

Codex

Run this command in your project:

codex plugin add stripe@openai-curated

Cursor

Run this command in your project:

/add-plugin stripe

You can also install through the Cursor marketplace.

Grok Build

Run this command in your project:

grok plugin install stripe --trust

Agent Plugins

Installation methods currently vary by client for the new Agent Plugins standard, but you can point your client to our package via:

• Git URL: https://github.com/stripe/ai
• Subdirectory: providers/agent-plugins/plugin/.

Manual installation

Manually installed skills don’t auto-update. Run npx skills update -y to get the latest versions.

Run this command in your project:

npx skills add https://docs.stripe.com

License

MIT