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.
- Site
- ups.com
- Functions
- 9
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/upsOne MCP server for UPS 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.
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
Name Type Required 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/calculateShippingCostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.calculateShippingCost({ fromZip: "20024", toZip: "10001", packageSize: "small" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.calculateShippingCost({ "fromZip": "20024", "toZip": "10001", "packageSize": "small" }))curl -X POST https://api.bowmark.ai/v1/sites/ups/calculateShippingCost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"fromZip":"20024","toZip":"10001","packageSize":"small"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/calculateTimeAndCostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.calculateTimeAndCost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.calculateTimeAndCost({}))curl -X POST https://api.bowmark.ai/v1/sites/ups/calculateTimeAndCost \ -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.ups.calculateTimeAndCost({});estimateDeliveryDateEstimates delivery date and timeframe for shipment between two locations with a selected service level.Arguments
Name Type Required 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/estimateDeliveryDateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.estimateDeliveryDate({ fromZip: "20024", toZip: "10001", weightOz: 16 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.estimateDeliveryDate({"fromZip": "20024", "toZip": "10001", "weightOz": 16}))curl -X POST https://api.bowmark.ai/v1/sites/ups/estimateDeliveryDate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"fromZip":"20024","toZip":"10001","weightOz":16}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/findNearbyLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.findNearbyLocation({ address: "20024" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.findNearbyLocation({"address": "20024"}))curl -X POST https://api.bowmark.ai/v1/sites/ups/findNearbyLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"address":"20024"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getRateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.getRate({ fromZip: "20024", toZip: "10001", weightOz: 16 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.getRate({"fromZip": "20024", "toZip": "10001", "weightOz": 16}))curl -X POST https://api.bowmark.ai/v1/sites/ups/getRate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"fromZip":"20024","toZip":"10001","weightOz":16}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ includeTargeted?: boolean }No Returns
UpsServiceAlertsinterface 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/getServiceAlertsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.getServiceAlerts({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.getServiceAlerts({}))curl -X POST https://api.bowmark.ai/v1/sites/ups/getServiceAlerts \ -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.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
Name Type Required args{ addressLine: string; city: string; state: string; zip: string; pickupDate?: string; residential?: boolean }Yes Returns
UpsPickupQuoteinterface 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/schedulePickupCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.schedulePickup({ addressLine: "1600 Pennsylvania Ave NW", city: "Washington", state: "DC", zip: "20500" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.schedulePickup({ "addressLine": "1600 Pennsylvania Ave NW", "city": "Washington", "state": "DC", "zip": "20500" }))curl -X POST https://api.bowmark.ai/v1/sites/ups/schedulePickup \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"addressLine":"1600 Pennsylvania Ave NW","city":"Washington","state":"DC","zip":"20500"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ trackingNumber: string }Yes Returns
upsTrackingResultinterface 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/trackShipmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.trackShipment({ trackingNumber: "1Z999AA10123456784" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.trackShipment({"trackingNumber": "1Z999AA10123456784"}))curl -X POST https://api.bowmark.ai/v1/sites/ups/trackShipment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"trackingNumber":"1Z999AA10123456784"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ups.trackShipment({ trackingNumber: "1Z999AA10123456784" });validateAddressValidates and standardizes a US shipping address against UPS's Address Validation API (XAV).Arguments
Name Type Required args{ addressLine: string; addressLine2?: string; city?: string; state?: string; zip?: string; countryCode?: string }Yes Returns
upsAddressValidationinterface 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/validateAddressCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ups.validateAddress({ addressLine: "1600 Pennsylvania Ave NW", city: "Washington", state: "DC", zip: "20500" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ups.validateAddress({ "addressLine": "1600 Pennsylvania Ave NW", "city": "Washington", "state": "DC", "zip": "20500" }))curl -X POST https://api.bowmark.ai/v1/sites/ups/validateAddress \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"addressLine":"1600 Pennsylvania Ave NW","city":"Washington","state":"DC","zip":"20500"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ups.validateAddress({ addressLine: "1600 Pennsylvania Ave NW", city: "Washington", state: "DC", zip: "20500" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/ups/<function> - OpenAPI
/v1/sites/ups/openapi.json