UPS MCP server for AI agents

Let Claude, ChatGPT or your own agent read UPS: 9 typed functions through one MCP server. No UPS API key needed.

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

Connect

Just UPS

An MCP server for UPS 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/ups
Every site

One MCP server for UPS 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 9
  • calculateShippingCostRetail shipping quote from ups.com's public calculator: UPS® Simple Rate (box-size category, no weight, no account) inside the US, or a…

    Arguments

    NameTypeRequired
    args{ fromZip: string; toZip: string; toCountry?: string; toCity?: string; packageSize?: "extraSmall" | "small" | "medium" | "large" | "extraLarge"; weightLbs?: number; lengthIn?: number; widthIn?: number; heightIn?: number; customsValue?: number; shipDate?: string }Yes

    Returns UpsSimpleRateQuote[]

    interface UpsSimpleRateQuote {
      serviceCode: string;
      serviceName: string;
      cost: number;
      currency: string;
      daysInTransit: number | null;  // null on an international lane: that page prints only the date
      deliveredBy: string | null;  // the site's own words, e.g. "By End of Day Monday October 26, 2026"
      guaranteed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/calculateShippingCost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.calculateShippingCost({ fromZip: "20024", toZip: "10001", packageSize: "small" });
  • calculateTimeAndCostPublic retail rates and delivery dates from ups.com's "Calculate Time and Cost" calculator for a weighed parcel between any two countries (e.g. DE…

    Arguments

    NameTypeRequired
    args{ fromCountry: string; fromPostalCode: string; fromCity?: string; toCountry: string; toPostalCode: string; toCity?: string; weight: number; length: number; width: number; height: number; units?: "metric" | "imperial"; customsValue?: number; shipDate?: string }Yes

    Returns UpsSimpleRateQuote[]

    interface UpsSimpleRateQuote {
      serviceCode: string;
      serviceName: string;
      cost: number;
      currency: string;
      daysInTransit: number | null;  // null on an international lane: that page prints only the date
      deliveredBy: string | null;  // the site's own words, e.g. "By End of Day Monday October 26, 2026"
      guaranteed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/calculateTimeAndCost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.calculateTimeAndCost({});
  • estimateDeliveryDateEstimates delivery date and timeframe for shipment between two locations with a selected service level.

    Arguments

    NameTypeRequired
    args{ fromZip: string; toZip: string; weightOz: number; length?: number; width?: number; height?: number; accountNumber?: string; shipDate?: string; serviceCode?: string }Yes

    Returns upsDeliveryEstimate[]

    interface upsDeliveryEstimate {
      serviceCode: string;
      serviceName: string;
      transitDays: number | null;
      estimatedDeliveryDate: string | null;  // YYYY-MM-DD, or null when UPS gave no GuaranteedDelivery block
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/estimateDeliveryDate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.estimateDeliveryDate({ fromZip: "20024", toZip: "10001", weightOz: 16 });
  • findNearbyLocationFinds UPS drop-off/pickup locations near a ZIP Code or street/city address.

    Arguments

    NameTypeRequired
    args{ address: string; maxResults?: number; locationTypes?: Array<"customerCenter" | "upsStore" | "dropBox" | "authorizedOutlet" | "mailBoxesEtc" | "retailChain" | "authorizedServiceProvider" | "accessPoint">; units?: "MI" | "KM" }Yes

    Returns UpsNearbyLocation[]

    interface UpsNearbyLocation {
      locationId: string;
      name: string;  // the business at this address, e.g. "CVS STORE # 10415"
      locationTypes: Array<"customerCenter" | "upsStore" | "dropBox" | "authorizedOutlet" | "mailBoxesEtc" | "retailChain" | "authorizedServiceProvider" | "accessPoint">;
      addressLine: string;
      city: string;
      state: string;
      zip: string;
      zipExtension: string | null;
      countryCode: string;
      lat: number;
      long: number;
      distance: number | null;
      distanceUnit: string | null;  // "MI" | "KM"
      phone: string | null;
      standardHoursOfOperation: string | null;
      latestGroundDropOffTime: string | null;
      latestAirDropOffTime: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/findNearbyLocation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.findNearbyLocation({ address: "20024" });
  • getRatePrices a domestic shipment across UPS's own service levels (Ground, 3 Day Select, 2nd Day Air, Next Day Air, etc.) between two ZIP codes for a given…

    Arguments

    NameTypeRequired
    args{ fromZip: string; toZip: string; weightOz: number; length?: number; width?: number; height?: number; accountNumber?: string }Yes

    Returns upsRatedShipment[]

    interface upsRatedShipment {
      serviceCode: string;
      serviceName: string;
      price: number;
      currency: string;
      transitDays: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/getRate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.getRate({ fromZip: "20024", toZip: "10001", weightOz: 16 });
  • getServiceAlertsUPS's own active service alerts (weather, natural disasters, regional disruptions) from www.ups.com/us/en/service-alerts, optionally including…

    Arguments

    NameTypeRequired
    args{ includeTargeted?: boolean }No

    Returns UpsServiceAlerts

    interface UpsServiceAlert {
      title: string;  // e.g. "Middle East Service Impacts"
      body: string;  // plain text, one paragraph or list item per line
      links: string[];
      targeted: boolean;  // true when UPS aims it at signed-in customer segments; hidden on the public page
      segment: string | null;  // UPS's own audience segment id, when one is set
      sourceUrl: string;
    }
    
    interface UpsServiceAlerts {
      alerts: UpsServiceAlert[];
      count: number;  // alerts.length; 0 is a real answer, "no active disruption"
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/getServiceAlerts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.getServiceAlerts({});
  • schedulePickupQuotes UPS's one-time pickup fee for a US address and date, through the guest Schedule a Pickup wizard's own pricing call.

    Arguments

    NameTypeRequired
    args{ addressLine: string; city: string; state: string; zip: string; pickupDate?: string; residential?: boolean }Yes

    Returns UpsPickupQuote

    interface UpsPickupQuote {
      booked: false;  // always false: this quotes the pickup fee and never books a driver
      pickupDate: string;  // YYYY-MM-DD
      hasCharges: boolean;
      baseCharge: number | null;
      surcharges: Record<string, number>;  // only the non-zero ones UPS itemized
      totalTax: number | null;
      grandTotal: number | null;
      currency: string;
      bookUrl: string;  // the wizard a person finishes the booking in
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/schedulePickup

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.schedulePickup({
      addressLine: "1600 Pennsylvania Ave NW",
      city: "Washington",
      state: "DC",
      zip: "20500"
    });
  • trackShipmentTracks a shipment by tracking number and returns status, delivery date, and current location.

    Arguments

    NameTypeRequired
    args{ trackingNumber: string }Yes

    Returns upsTrackingResult

    interface upsTrackingResult {
      trackingNumber: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      currentLocation: string | null;
      deliveryDate: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/trackShipment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.trackShipment({ trackingNumber: "1Z999AA10123456784" });
  • validateAddressValidates and standardizes a US shipping address against UPS's Address Validation API (XAV).

    Arguments

    NameTypeRequired
    args{ addressLine: string; addressLine2?: string; city?: string; state?: string; zip?: string; countryCode?: string }Yes

    Returns upsAddressValidation

    interface upsAddressCandidate {
      addressLines: string[];
      city: string;
      state: string;
      zip: string;
      zipExtension: string | null;
      countryCode: string;
      classification: string | null;  // "Commercial" | "Residential" | "Unknown" | null
    }
    
    interface upsAddressValidation {
      valid: boolean;       // true when the address as given was an exact match
      ambiguous: boolean;   // true when UPS found more than one plausible standardized form
      candidates: upsAddressCandidate[];  // empty when UPS could not match the address at all
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ups/validateAddress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ups.validateAddress({
      addressLine: "1600 Pennsylvania Ave NW",
      city: "Washington",
      state: "DC",
      zip: "20500"
    });

Use it from code