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.

Functions
10
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just PayPal

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/paypal
Every site

One MCP server for PayPal and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 10
  • estimateFeeComputes what PayPal charges to send a PERSONAL (friends-and-family) payment.

    Arguments

    NameTypeRequired
    amountnumber
    > 0, in currency.
    Yes
    currencystring
    ISO 4217, e.g. "USD".
    Yes
    crossBorderboolean
    Sender and recipient in different countries.
    Yes
    fundingSource"balance" | "bank" | "card" | "amexSend"Yes

    Returns PaypalFeeEstimate

    interface 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/estimateFee

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.estimateFee({
      amount: 100,
      currency: "USD",
      crossBorder: false,
      fundingSource: "balance"
    });
  • estimatePayLaterPlanTurns a purchase amount into PayPal's Pay Later options.

    Arguments

    NameTypeRequired
    amountnumber
    Accepted but ignored, Pay Later terms are published, not amount-specific.
    No

    Returns PaypalPayLaterPlan

    interface 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/estimatePayLaterPlan

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.estimatePayLaterPlan({});
  • getCurrencyConversionQuoteReads PayPal's published currency-conversion spread (FEETB26.

    Arguments

    NameTypeRequired
    kindPaypalConversionKind
    "goodsOrServices" | "personal" | "payouts" | "other".
    No
    audience"consumer"
    Defaults to "consumer"; merchant is a separate, unverified page.
    No
    countrystring
    ISO 3166-1 alpha-2, defaults to "us"; only "us" is verified end-to-end.
    No

    Returns PaypalCurrencyConversionQuote

    type 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/getCurrencyConversionQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.getCurrencyConversionQuote({ kind: "goodsOrServices" });
  • getFeesReads PayPal's own published fee schedule for a country and audience (consumer or merchant).

    Arguments

    NameTypeRequired
    audience"consumer" | "merchant"
    Defaults to "consumer"; "merchant" = goods-and-services / business rates.
    No
    countrystring
    ISO 3166-1 alpha-2, defaults to "us"; only "us" is verified end-to-end.
    No

    Returns PaypalFeeSchedule

    interface 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/getFees

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.getFees({});
  • getHelpArticleReads one PayPal help article in full by its id.

    Arguments

    NameTypeRequired
    args{ articleId: string }Yes

    Returns PaypalHelpArticle

    interface 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/getHelpArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.getHelpArticle({ articleId: "HELP101" });
  • getPayPalMeProfileResolves a PayPal.Me link or handle to the public profile behind it.

    Arguments

    NameTypeRequired
    args{ handle: string }Yes

    Returns PaypalMeProfile

    interface 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/getPayPalMeProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.getPayPalMeProfile({ handle: "LeeDread" });
  • getPolicyDocumentReads one of PayPal's binding policy documents from the legal hub.

    Arguments

    NameTypeRequired
    args{ documentKey: PaypalPolicyDocumentKey }Yes
    type PaypalPolicyDocumentKey = "user-agreement" | "seller-protection" | "privacy" | "balance-terms" | "cryptocurrency-terms";

    Returns PaypalPolicyDocument

    type 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/getPolicyDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.getPolicyDocument({ documentKey: "user-agreement" });
  • getServiceStatusAnswers 'is PayPal down right now?' off PayPal's own status page.

    Arguments

    NameTypeRequired
    args{ component?: string }No

    Returns PaypalServiceStatus

    interface 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/getServiceStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.getServiceStatus({});
  • searchHelpSearches PayPal's Help Center and returns the matching articles.

    Arguments

    NameTypeRequired
    args{ query: string }Yes

    Returns PaypalHelpSearchResults

    interface 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/searchHelp

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.searchHelp({ query: "payment on hold" });
  • searchShoppingOffersLists the cashback and discount offers PayPal's Shopping explore feed is currently running.

    Arguments

    NameTypeRequired
    args{ merchant?: string }No

    Returns PaypalShoppingOffersResult

    interface 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/searchShoppingOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.paypal.searchShoppingOffers({});

Use it from code