PayPal MCP Server — Hosted Payments Integration
MCP Server shield Key RequiredOrders, payments, subscriptions, payouts via PayPal's official MCP
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"paypal-payments": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-paypal",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the create_order tool to create a new paypal order with line items, currency, and purchase unit details for checkout”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
PayPal Payments MCP
Official proxy MCP — Orders, payments, subscriptions, payouts via PayPal's official MCP
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-paypal
Overview
PayPal Payments is a proxy MCP server that forwards requests directly to the official PayPal MCP endpoint at https://mcp.paypal.com. All tools are maintained by PayPal — new tools are available immediately without any Aerostack update.
Type: Proxy (hosted by PayPal)
Auth: Bearer token via PAYPAL_ACCESS_TOKEN
Available Tools
- create_order — Create a new PayPal order with line items, currency, and purchase unit details for checkout
- capture_payment — Capture payment for an approved PayPal order, finalizing the transaction and moving funds
- get_order — Retrieve the details and current status of a PayPal order by its order ID
- list_transactions — List PayPal transaction history for the account within a specified date range
- create_invoice — Create a PayPal invoice with line items, due date, and recipient details for billing
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
PAYPAL_ACCESS_TOKEN |
Yes | PayPal REST API Access Token | developer.paypal.com → My Apps → Create App → Copy Client ID + Secret, then get access token via OAuth |
Setup
Add to Aerostack Workspace
- Go to app.aerostack.dev/workspaces → Create Workspace
- Inside your workspace → Add Server → search "PayPal Payments"
- Enter your
PAYPAL_ACCESS_TOKENwhen prompted — stored encrypted, injected automatically
Once added, every AI agent in your workspace can use PayPal tools automatically.
Usage
Example Prompts
"List all my PayPal items and summarize the most recent ones"
"Find anything related to [keyword] in PayPal"
"Create a new entry with the following details: ..."
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-paypal \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-PAYPAL-ACCESS-TOKEN: your-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_order","arguments":{}}}'
License
MIT
terminal Tools (5)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
create_order #1 Create a new PayPal order with line items, currency, and purchase unit details for checkout
capture_payment #2 Capture payment for an approved PayPal order, finalizing the transaction and moving funds
get_order #3 Retrieve the details and current status of a PayPal order by its order ID
list_transactions #4 List PayPal transaction history for the account within a specified date range
create_invoice #5 Create a PayPal invoice with line items, due date, and recipient details for billing
Details
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in Payments
Browse Payments MCPs →Frequently asked questions
What is the PayPal MCP server and what can it do? +
The PayPal MCP server is hosted on Aerostack and exposes these tools to your AI agent: `create_order`, `capture_payment`, `get_order`, `list_transactions`, `create_invoice`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the PayPal MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the PayPal MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same PayPal MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the PayPal MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-paypal": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-paypal"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the PayPal MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-paypal", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-paypal"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does PayPal MCP require authentication? +
Yes. PayPal uses Bearer token authentication. Set your token as a workspace secret in the Aerostack dashboard.