PayPal MCP server for AI agents
Let Claude, ChatGPT or your own agent read PayPal: 10 typed functions through one MCP server. No PayPal API key needed.
- Site
- paypal.com
- Functions
- 10
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for PayPal alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/paypalOne MCP server for PayPal and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
estimateFeeComputes what PayPal charges to send a PERSONAL (friends-and-family) payment.Arguments
Name Type Required amountnumber> 0, in currency.Yes currencystringISO 4217, e.g. "USD".Yes crossBorderbooleanSender and recipient in different countries.Yes fundingSource"balance" | "bank" | "card" | "amexSend"Yes Returns
PaypalFeeEstimateinterface PaypalFeeCitation { documentId: string; // the CMS fee-table id this figure came from, e.g. "FEETB20" feeDataKey: string; // the exact published value used, e.g. "2.90%" internalName: string; } interface PaypalFeeEstimate { amount: number; currency: string; crossBorder: boolean; fundingSource: "balance" | "bank" | "card" | "amexSend"; fee: number; net: number; // amount - fee citations: PaypalFeeCitation[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/estimateFeeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.estimateFee({ amount: 100, currency: "USD", crossBorder: false, fundingSource: "balance" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.estimateFee({ "amount": 100, "currency": "USD", "crossBorder": False, "fundingSource": "balance" }))curl -X POST https://api.bowmark.ai/v1/sites/paypal/estimateFee \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"amount":100,"currency":"USD","crossBorder":false,"fundingSource":"balance"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.estimateFee({ amount: 100, currency: "USD", crossBorder: false, fundingSource: "balance" });estimatePayLaterPlanTurns a purchase amount into PayPal's Pay Later options.Arguments
Name Type Required amountnumberAccepted but ignored, Pay Later terms are published, not amount-specific.No Returns
PaypalPayLaterPlaninterface PaypalPayInFourPlan { name: "Pay in 4"; instalments: number; frequency: "every 2 weeks"; apr: 0; } interface PaypalPayMonthlyTerms { name: "Pay Monthly"; termLengths: string[]; // e.g. ["3 months", "6 months", "12 months", "24 months"] aprRange: string | null; // the published fixed-APR range, e.g. "0-35.99%" note: string; } interface PaypalPayLaterPlan { payIn4: PaypalPayInFourPlan; payMonthly: PaypalPayMonthlyTerms; sourceUrl: string; lastChecked: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/estimatePayLaterPlanCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.estimatePayLaterPlan({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.estimatePayLaterPlan({}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/estimatePayLaterPlan \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.estimatePayLaterPlan({});getCurrencyConversionQuoteReads PayPal's published currency-conversion spread (FEETB26.Arguments
Name Type Required kindPaypalConversionKind"goodsOrServices" | "personal" | "payouts" | "other".No audience"consumer"Defaults to "consumer"; merchant is a separate, unverified page.No countrystringISO 3166-1 alpha-2, defaults to "us"; only "us" is verified end-to-end.No Returns
PaypalCurrencyConversionQuotetype PaypalConversionKind = "goodsOrServices" | "personal" | "payouts" | "other"; interface PaypalCurrencyConversionCitation { documentId: string; // the CMS table id this figure came from, e.g. "FEETB26" feeDataKey: string; // the exact published value used, e.g. "4.00%" internalName: string; } interface PaypalCurrencyConversionQuote { kind: PaypalConversionKind; // which PayPal-conversion context the spread applies to paypalSpread: number; // 0.04 for goodsOrServices/personal/payouts; 0.03 for "other" citations: { paypal: PaypalCurrencyConversionCitation }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/getCurrencyConversionQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.getCurrencyConversionQuote({ kind: "goodsOrServices" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.getCurrencyConversionQuote({"kind": "goodsOrServices"}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/getCurrencyConversionQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"kind":"goodsOrServices"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.getCurrencyConversionQuote({ kind: "goodsOrServices" });getFeesReads PayPal's own published fee schedule for a country and audience (consumer or merchant).Arguments
Name Type Required audience"consumer" | "merchant"Defaults to "consumer"; "merchant" = goods-and-services / business rates.No countrystringISO 3166-1 alpha-2, defaults to "us"; only "us" is verified end-to-end.No Returns
PaypalFeeScheduleinterface PaypalFeeCitation { documentId: string; // the CMS fee-table id this figure came from, e.g. "FEETB20" feeDataKey: string; // the exact published value used, e.g. "2.90%" internalName: string; } interface PaypalFeeToken { feeDataKey: string; // the exact published value, e.g. "2.90%" or "0.30 USD" internalName: string; percent: number | null; // 0.029 when "2.90%", else null amount: { amount: number; currency: string } | null; // when "0.30 USD", else null } interface PaypalFeeRow { labels: string[]; // plain-text label cells, in cell order tokens: PaypalFeeToken[]; // every published fee token on the row, across all columns cells: string[]; // plain-text rendering of each cell, in cell order noFee: boolean; // true iff the row carries no fee token (PayPal's "No fee" rows) citations: PaypalFeeCitation[]; } interface PaypalFeeTable { documentId: string; // the CMS fee-table id, e.g. "FEETB20" caption: string; // PayPal's own caption, e.g. "Sending domestic personal transactions" rows: PaypalFeeRow[]; } interface PaypalFeeSchedule { audience: "consumer" | "merchant"; country: string; // lowercased to match PayPal's URL path, e.g. "us" sourceUrl: string; tables: PaypalFeeTable[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/getFeesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.getFees({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.getFees({}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/getFees \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.getFees({});getHelpArticleReads one PayPal help article in full by its id.Arguments
Name Type Required args{ articleId: string }Yes Returns
PaypalHelpArticleinterface PaypalHelpArticle { articleId: string; // PayPal's own help-article id, same spelling searchHelp returned title: string; topicId: string; topicName: string; content: string; // the full article body, as PayPal publishes it (HTML) excerpt: string; sourceUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/getHelpArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.getHelpArticle({ articleId: "HELP101" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.getHelpArticle({"articleId": "HELP101"}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/getHelpArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"articleId":"HELP101"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.getHelpArticle({ articleId: "HELP101" });getPayPalMeProfileResolves a PayPal.Me link or handle to the public profile behind it.Arguments
Name Type Required args{ handle: string }Yes Returns
PaypalMeProfileinterface PaypalMeProfile { handle: string; found: boolean; // false means the handle does not resolve to a live profile displayName: string | null; location: string | null; profilePhotoUrl: string | null; primaryCurrencyCode: string | null; intent: string | null; // "PERSONAL" or "BUSINESS" socials: { instagram: string | null; facebook: string | null; twitter: string | null; website: string | null }; profileUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/getPayPalMeProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.getPayPalMeProfile({ handle: "LeeDread" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.getPayPalMeProfile({"handle": "LeeDread"}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/getPayPalMeProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"LeeDread"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.getPayPalMeProfile({ handle: "LeeDread" });getPolicyDocumentReads one of PayPal's binding policy documents from the legal hub.Arguments
Name Type Required args{ documentKey: PaypalPolicyDocumentKey }Yes type PaypalPolicyDocumentKey = "user-agreement" | "seller-protection" | "privacy" | "balance-terms" | "cryptocurrency-terms";Returns
PaypalPolicyDocumenttype PaypalPolicyDocumentKey = "user-agreement" | "seller-protection" | "privacy" | "balance-terms" | "cryptocurrency-terms"; interface PaypalPolicySection { id: string; // the page's own anchor, e.g. "what-eligible" title: string; content: string; // the clauses as plain text, one paragraph or list item per line } interface PaypalPolicyDocument { documentKey: PaypalPolicyDocumentKey; title: string; lastModified: string | null; // PayPal's own "Last updated on …" line, verbatim sections: PaypalPolicySection[]; sourceUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/getPolicyDocumentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.getPolicyDocument({ documentKey: "user-agreement" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.getPolicyDocument({"documentKey": "user-agreement"}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/getPolicyDocument \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"documentKey":"user-agreement"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.getPolicyDocument({ documentKey: "user-agreement" });getServiceStatusAnswers 'is PayPal down right now?' off PayPal's own status page.Arguments
Name Type Required args{ component?: string }No Returns
PaypalServiceStatusinterface PaypalServiceComponent { id: number; name: string; parent: string | null; // e.g. "Online Checkout", "REST APIs"; null when top-level brand: string | null; // "PayPal", "Venmo", "Enterprise Solutions (Braintree)", … category: string; // "product" | "api" production: string | null; // PayPal's label, e.g. "Operational"; null when no such environment sandbox: string | null; } interface PaypalServiceStatus { allOperational: boolean; // every production status present reads "Operational" degraded: PaypalServiceComponent[]; components: PaypalServiceComponent[]; sourceUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/getServiceStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.getServiceStatus({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.getServiceStatus({}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/getServiceStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.getServiceStatus({});searchHelpSearches PayPal's Help Center and returns the matching articles.Arguments
Name Type Required args{ query: string }Yes Returns
PaypalHelpSearchResultsinterface PaypalHelpSearchResult { articleId: string; // PayPal's own help-article id, pass to getHelpArticle title: string; excerpt: string; rank: number; // PayPal's own result ordering, 1-indexed } interface PaypalHelpSearchResults { query: string; results: PaypalHelpSearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/searchHelpCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.searchHelp({ query: "payment on hold" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.searchHelp({"query": "payment on hold"}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/searchHelp \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"payment on hold"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.searchHelp({ query: "payment on hold" });searchShoppingOffersLists the cashback and discount offers PayPal's Shopping explore feed is currently running.Arguments
Name Type Required args{ merchant?: string }No Returns
PaypalShoppingOffersResultinterface PaypalShoppingOffer { merchant: string; reward: string; // PayPal's own card-face reward text, e.g. "5% back" description: string; tags: string[]; storeIds: string[]; campaignId: string; // PayPal's own campaign id, stable, not a display label detailsUrl: string | null; } interface PaypalShoppingOffersResult { merchant: string | null; // echoes the caller's filter, or null when none was given offers: PaypalShoppingOffer[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/paypal/searchShoppingOffersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.paypal.searchShoppingOffers({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.paypal.searchShoppingOffers({}))curl -X POST https://api.bowmark.ai/v1/sites/paypal/searchShoppingOffers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.paypal.searchShoppingOffers({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/paypal/<function> - OpenAPI
/v1/sites/paypal/openapi.json