Connect
Optimize
Secure
PayPal MCP Server
for AI Agents
Production-ready PayPal MCP server with 54 extensible actions — plus built-in authentication, security, and optimized execution.
PayPal MCP Server
Built by 
StackOne
StackOne 
Coverage
54 Agent Actions
Create, read, update, and delete across PayPal — and extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your PayPal MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →
Security
Agent Protection
Every PayPal tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.
Prompt Injection Defense →
Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every PayPal call.
Tools Discovery →What is the PayPal MCP Server?
A PayPal MCP server lets AI agents read and write PayPal data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's PayPal MCP server ships with 54 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, and optimized agent context. Connect it from MCP clients like Claude Desktop, Cursor, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All PayPal MCP Tools and Actions
Every action from PayPal's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.
Orders
- Create Order
Create a new PayPal order for payment processing
- Get Order
Show details for an order by ID
- Update Order
Update an order with CREATED or APPROVED status
Invoices
- Send Invoice
Send or schedule a draft invoice to the recipient
- List Invoices
List invoices with optional filtering and pagination
- Get Invoice
Retrieve details of a specific invoice by ID
- Search Invoices
Search for invoices using filters
- Update Invoice
Fully update an existing invoice
- Delete Invoice
Delete a draft invoice by ID
Products
- Create Product
Create a new catalog product
- List Products
List catalog products with pagination
- Get Product
Retrieve details of a specific catalog product
- Update Product
Update a catalog product
Subscription Plans
- Create Subscription Plan
Create a new subscription billing plan
- List Subscription Plans
List subscription billing plans with pagination
- Get Subscription Plan
Retrieve details of a specific subscription plan
Subscriptions
- Create Subscription
Create a new subscription for a plan
- Get Subscription
Retrieve details of a specific subscription
Payouts
- Create Batch Payout
Create a batch payout to send payments to multiple recipients
- Get Batch Payout
Retrieve details of a batch payout
Disputes
- List Disputes
List disputes with optional filtering
- Get Dispute
Retrieve details of a specific dispute
Webhooks
- Create Webhook
Create a new webhook to receive event notifications
- List Webhooks
List all webhooks for the app
- Get Webhook
Show webhook details
- Delete Webhook
Delete a webhook by ID
Other (28)
- Create Draft Invoice
Create a new draft invoice
- Send Invoice Reminder
Send a reminder to the payer about an invoice
- Send Dispute Message
Send a message about a dispute to the other party
- Get Captured Payment
Retrieve details of a captured payment
- Get Refund
Retrieve details of a specific refund
- Get Authorization
Retrieve details of an authorized payment
- List Subscription Transactions
List transactions for a specific subscription
- Get Payout Item
Retrieve details of a specific payout item
- List Transactions
Search for transactions within a date range
- List Balances
List account balances by currency
- List Webhook Event Types
List all available webhook event types
- List Webhook Event Notifications
List webhook event notifications with optional filtering
- Delete External Payment
Delete an external payment from an invoice
- Capture Order Payment
Capture payment for an approved order
- Authorize Order Payment
Authorize payment for an approved order
- Refund Captured Payment
Refund a captured payment in full or partially
- Capture Authorized Payment
Capture an authorized payment
- Void Authorization
Void an authorized payment
- Cancel Sent Invoice
Cancel a sent invoice
- Record Invoice Payment
Record a payment for an invoice
- Generate Invoice Number
Generate the next sequential invoice number
- Record Invoice Refund
Record a refund for an invoice
- Cancel Subscription
Cancel an active subscription
- Suspend Subscription
Suspend an active subscription
- Activate Subscription
Activate a suspended subscription
- Cancel Unclaimed Payout Item
Cancel an unclaimed payout item
- Accept Dispute Claim
Accept a dispute claim and refund the buyer
- Escalate Dispute To Claim
Escalate a dispute to a PayPal claim
Set Up Your PayPal MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to PayPal in under 10 lines of code.
MCP Clients
Agent Frameworks
JSON{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}More Commerce MCP Servers
Klaviyo
162+ actions
Stripe
133+ actions
Magento
125+ actions
Square
125+ actions
BigCommerce
120+ actions
Eventbrite
73+ actions
Gorgias
69+ actions
PayPal MCP Server Resources
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
PayPal MCP Server FAQ
PayPal MCP server vs direct API integration — what's the difference?
A PayPal MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling PayPal. A PayPal MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling PayPal at runtime. StackOne provides both.
How does PayPal authentication work for AI agents?
PayPal authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own PayPal account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via
origin_owner_id.Are PayPal MCP tools vulnerable to prompt injection?
Yes — PayPal MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a PayPal agent and how do I avoid it?
Context bloat happens when PayPal tool schemas and API responses eat your PayPal agent's memory, preventing it from reasoning effectively. A single PayPal query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my PayPal agent can access?
Yes — you can limit which actions your PayPal agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my PayPal MCP server?
Yes — you can create custom agent actions for your PayPal MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research PayPal's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a PayPal MCP server?
Skip a PayPal MCP server if your integration is purely software-to-software — direct PayPal API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call PayPal actions at runtime.
What AI frameworks and AI clients does the StackOne PayPal MCP server support?
The StackOne PayPal MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.