Paypal MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Paypal MCP or direct API to create invoices, retrieve payments, manage orders, and process refunds through natural language.

Paypal logoPaypal
S2s Oauth2

PayPal is an online payment platform for sending, receiving, and managing money. It helps businesses accept payments, handle invoices, and process transactions globally.

78 Tools

Try Paypal now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Paypal
Try asking
TOOLS

Supported Tools

Every Paypal action and event your agent gets out of the box.

Activate billing plan

Activates a billing plan in PayPal, making it available for subscription signups.

Add Batch Tracking Information

Add tracking information for multiple PayPal transactions in a single request.

Authorize order payment

Authorizes payment for an order.

Cancel Invoice

Cancels a sent PayPal invoice and optionally notifies relevant parties.

Cancel Invoice Reminders

Cancels the automatic payment reminders for a PayPal invoice.

Capture subscription payment

Captures an authorized payment on a PayPal subscription.

Charge Payment Method

Charges a payment method and captures funds immediately using Braintree GraphQL API.

Create invoice

Creates a PayPal draft invoice.

Create PayPal payment

Creates a PayPal payment using the v1 Payments API.

Create billing plan (legacy)

Creates a PayPal billing plan using the legacy payments API (POST /v1/payments/billing-plans).

Create a billing plan

Creates a PayPal billing plan for subscription billing.

Create Product

Creates a new product in PayPal's catalog.

Create Subscription

Creates a new PayPal subscription based on a billing plan.

Create template

Creates a PayPal invoice template.

Create a webhook

Creates a PayPal webhook endpoint to receive notifications about events.

Create a webhook lookup

Creates a new PayPal webhook lookup to verify a webhook signature.

Create a web experience profile

Creates a PayPal web experience profile for customizing checkout.

Deactivate Plan

Deactivates a PayPal billing plan, making it unavailable for new subscriptions while preserving existing subscriptions.

Delete Invoice External Payment

Permanently deletes an external payment from a specified PayPal invoice.

Delete Invoice

Deletes a PayPal invoice by its ID.

Delete invoice payment record

Deletes a payment record from a PayPal invoice.

Delete Invoice Refund Record

Permanently deletes a refund record from a specified PayPal invoice.

Delete Payment Resource

Deletes a PayPal payment resource.

Delete Template

Deletes a PayPal invoice template by its ID.

Delete Webhook

Deletes a PayPal webhook by its ID.

Delete Web Experience Profile

Deletes a PayPal web experience profile by its ID.

Fetch Braintree Node

Fetches any object that extends the Node interface using its ID.

Finalize Braintree Dispute

Finalizes a Braintree dispute after adding evidence, submitting it to the cardholder's bank for review.

Find eligible PayPal payment methods

Find a list of eligible payment methods for a customer.

Generate PayPal Client Token

Generate a client token for PayPal JavaScript SDK integration.

Generate Next Invoice Number

Generates the next invoice number from PayPal's invoicing service.

Generate Next Invoice Number (v2)

Generates the next invoice number from PayPal's invoicing service using the v2 API.

Generate Invoice QR Code

Generates a QR code image for a PayPal invoice using the v2 invoicing API.

List Billing Subscriptions

Lists PayPal billing subscriptions for the merchant account.

Get Invoice

Retrieves detailed information about a specific PayPal invoice by its ID.

Get Invoice QR Code

Generates a QR code image for a PayPal invoice.

Get Invoice Template

Retrieves detailed information about a specific PayPal invoice template by its ID.

Get Order Details

Retrieves detailed information about a specific PayPal order by its ID.

Get Payment Details

Retrieves details for a PayPal payment by its ID using the deprecated v1 Payments API.

Get Refund Details

Retrieves details for a PayPal refund by its ID.

Get Plan

Retrieves details for a specific PayPal billing plan by its ID.

Get Product

Retrieves detailed information about a specific PayPal product by its ID.

Get Subscription Details

Retrieves the details of a PayPal subscription by its ID.

Get PayPal User Info

Retrieves user claims from PayPal using OpenID Connect.

Get User Info

Retrieves user profile information from PayPal.

Get Webhook

Retrieves detailed information about a specific PayPal webhook by its ID.

Get Webhook Lookup

Retrieves detailed information about a specific PayPal webhook lookup by its ID.

Get Web Profile

Retrieves detailed information about a PayPal web experience profile by its ID.

List PayPal Disputes

List PayPal customer disputes with optional filtering by date, transaction, or state.

List PayPal Invoices

List invoices from PayPal with pagination support.

List Legacy Billing Plans

Lists billing plans using the legacy PayPal payments API (v1/payments/billing-plans).

List Payments

Lists payment information for authorized payments.

List billing plans

Lists billing plans from PayPal with optional filtering and pagination.

List PayPal Products

List products from the PayPal product catalog.

List PayPal Invoice Templates

List invoice templates from PayPal.

List webhook event types

Lists all available PayPal webhook event types to which you can subscribe.

List webhook event type subscriptions

Lists event type subscriptions for a specific PayPal webhook.

List webhook lookups

Lists all webhook lookups associated with your PayPal application.

List Webhooks

Lists webhooks configured for an application or PayPal account.

List web experience profiles

Lists web experience profiles from PayPal with optional pagination.

Update checkout order (partial)

Partially updates a PayPal checkout order using JSON Patch (RFC 6902) operations.

Update billing plan (partial)

Partially updates a PayPal billing plan using JSON Patch (RFC 6902) operations.

Update Subscription

Update a PayPal subscription using JSON Patch operations.

Update web experience profile (partial)

Partially updates a PayPal web experience profile using JSON Patch (RFC 6902) operations.

Braintree Ping

Sends a ping query to the PayPal Braintree GraphQL API.

Query Braintree Report

Queries Braintree reports via GraphQL API.

Retrieve Payment Resource

Retrieve a PayPal payment resource by its ID.

Search PayPal Invoices

Search for PayPal invoices based on various filter criteria.

Send Invoice

Sends a PayPal invoice to the recipient via email.

Simulate Webhook Event

Simulates a webhook event to test your webhook integration.

Update Dispute

Partially update a PayPal dispute using JSON Patch operations.

Update Invoice (Full)

Fully updates a PayPal invoice by replacing the entire invoice with the provided data.

Update product (partial)

Partially updates a PayPal product using JSON Patch (RFC 6902) operations.

Update Webhook

Updates a PayPal webhook using JSON Patch (RFC 6902) operations.

Update template

Fully updates a PayPal invoice template.

Update web experience profile

Updates a PayPal web experience profile.

Verify Payment Method via Braintree

Verifies a multi-use payment method to ensure it has passed fraud rules and is associated with a valid account.

Verify Webhook Signature

Verifies the signature of a PayPal webhook notification to confirm its authenticity.

SETUP GUIDE

Connect Paypal MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Paypal
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List recent PayPal payments from this week and summarize the total received'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Paypal API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Paypal Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a PayPal invoice for customer@example.com for $250 for consulting services due next week'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Paypal actions with your Agent

Why Use Composio?

AI Native Paypal Integration

  • Supports both Paypal MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable payment, invoice, and order actions
  • Rich coverage for reading, writing, and querying your Paypal transaction data

Managed Auth

  • Built-in S2S OAuth2 handling with automatic token refresh and lifecycle management
  • Central place to manage, scope, and revoke Paypal access
  • Per user and per environment credentials instead of hard-coded payment keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear execution logs so you know which Paypal action ran, when, and on whose behalf
  • Designed so agents can safely handle practical workflows like invoice lookup, payment checks, and refund requests

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Paypal
  • Scoped, least privilege access to Paypal resources
  • Full audit trail of agent actions to support payment review and compliance
FRAMEWORKS

Use Paypal with any AI Agent Framework

Choose a Framework you want to connect Paypal with

FAQ

Frequently asked questions

Yes, Paypal requires you to configure your own S2S OAuth2 credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Paypal.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Paypal tool your agent needs.Free to start.

Start building