# Skydropx API MCP > Skydropx API. Manages end-to-end e-commerce logistics for Latin America. Use your AI client to instantly compare real-time carrier rates (DHL, Estafeta, FedEx), generate legal PDF shipping labels, track parcels live by waypoint, and manage shipment records—all from a single prompt. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** parcel-tracking, carrier-quotes, label-generation, logistics-automation, supply-chain ## Description Skydropx's whole logistics operation runs through this API. It connects your AI client to handle everything for e-commerce shipping across Latin America, from getting a quote right down to tracking the package once it’s out the door. You just tell your agent what you need done, and we execute the complex, multi-step tasks. **Preparation and Setup:** When you're starting out or verifying inputs, you gotta check the system first. Run `list_carriers` if you want to see a list of all local mail carriers synced in the platform. Before building anything, you can run `list_locations` to pull up every registered origin warehouse and dispatch spot we track. Need package dimensions? Don't manually type 'em; use `list_packages` to check out pre-saved templates for standard items. **Calculating Rates:** To find out how much shipping is gonna cost, you run `get_quotation`. You feed it the package details—the specific dimensions and the destination ZIP code—and the tool instantly compares real-time rates from carriers like DHL, Estafeta, and FedEx. This gives you a quick cost estimate before committing to anything. **Building Shipments:** Before generating any labels or tracking numbers, you gotta create the shipment record first. You use `create_shipment` to draft and save the whole profile, specifying dimensions and target locations for later use. If you need to look up details on a shipment that’s already been created but you don't have the ID handy, run `get_shipment`. It pulls the full profile of any existing, saved shipment record using either its unique ID or specific parameters. **Generating and Managing Labels:** Once the shipment is drafted, generating the label is simple. You execute `create_label` to purchase and generate a PDF shipping label based on that established shipment record. If you need to see what labels you’ve already made, run `list_labels` for an inventory of all active or previously created records. Remember, if you change your mind about a purchased label, you can void it using `cancel_label`; this action initiates the process to refund the fee right back to your account balance. **Tracking and History:** When the package is on its way, you don't wanna guess where it is. Use `get_tracking` to pull real-time status and waypoint history for any tracking number from all connected carriers. You get exactly where the package is right now. To keep a running tally of everything that’s ever shipped through the system, run `list_shipments`, which gives you an index of all active or historical e-commerce shipment records stored in your account. This API handles every piece of the puzzle: it gets you the cost estimate (`get_quotation`), builds the record (`create_shipment` / `get_shipment`), prints the label (`create_label`), and tells you exactly where the package is (`get_tracking`). It keeps your whole logistics flow running on time. ## Tools ### cancel_label Void an active shipping label record, which initiates the process to refund the fee to your account balance. ### create_label Purchases and generates a PDF file for a new shipping label based on existing shipment data. ### create_package Registers a standardized package format (e.g., 'Medium Box, 10x8x5') that can be reused across multiple shipments. ### create_shipment Drafts and saves a brand new shipment record using specific dimensions and target locations for later use. ### get_quotation Compares real-time shipping carrier rates by accepting package details and destination ZIP codes. ### get_shipment Retrieves the full profile of an existing, saved shipment record using its unique ID or parameters. ### get_tracking Pulls real-time status and waypoint history for a specific package tracking number from all connected carriers. ### list_carriers Retrieves a list of all local mail carriers currently synced and available in the system. ### list_labels Shows an inventory of previously created or active shipping label records (guides). ### list_locations Retrieves a list of all registered origin warehouses and dispatch locations. ### list_packages Lists pre-saved standard package templates, so you don't have to manually input dimensions every time. ### list_shipments Shows an index of all active or historical e-commerce shipment records stored in your account. ## Prompt Examples **Prompt:** ``` We need to create a shipment calculation instance right now. Add a medium box weighing 2KG targeting CP '88392' in MX. ``` **Response:** ``` Request compiled correctly into Skydropx matrices! Generated internal Shipment instance. The new UUID allocated rests functionally. I am ready to jump onto pulling Native Carrier Quotes based on this profile. Do we proceed asking the fleets? ``` **Prompt:** ``` Search exactly where the package numbered 'SKY099-B' currently sits from our past dispatch. ``` **Response:** ``` Tracking network probed! Internal records show 'SKY099-B' marked strongly as [DELIVERED]. The checkpoint occurred cleanly yesterday at 14:00. The proof of signature registers 'Maria'. We closed this flawlessly over local Carrier logs. ``` **Prompt:** ``` List all origin locations ``` **Response:** ``` Here. ``` ## Capabilities ### Calculate Real-Time Shipping Rates Run the `get_quotation` tool using package dimensions and destination ZIP codes to compare rates from multiple carriers. ### Draft and Generate Shipment Records Use `create_shipment` to build a new shipment profile, which is required before generating any tracking or labels. ### Generate Printable Shipping Labels Execute the `create_label` tool to purchase and generate a PDF label based on an existing shipment record. ### Monitor Parcel Status Live The `get_tracking` tool pulls real-time waypoint data for any tracking number, showing where the package actually is. ### List All Operational Data Points Access helper tools like `list_carriers`, `list_locations`, and `list_packages` to verify system inputs before running a main task. ## Use Cases ### A client needs a rate quote for an international order. The agent runs `get_quotation`, feeding it the package dimensions and the remote ZIP code. The tool immediately compares DHL, Estafeta, and FedEx rates, presenting three actionable choices to finalize the best price. ### A dispatch run needs labels for 50 boxes. The operations lead runs `list_packages` first to confirm templates. Then, they use `create_shipment` repeatedly in a loop, followed by calling `create_label` for each one. Labels print instantly without human intervention. ### A customer calls asking 'Where is my package?' Instead of opening the tracking portal, the agent uses `get_tracking`, entering only the tracking number. The tool pulls live status updates—'In Transit,' 'At Local Hub,' etc.—and provides a clear update to the client. ### A shipment was ordered by mistake and needs to be stopped. The user simply asks the agent to cancel it. The system runs `cancel_label`, confirming the cancellation and automatically flagging the necessary refund process, saving time on manual administrative tasks. ## Benefits - Instantly compare rates from multiple carriers. The `get_quotation` tool queries DHL, Estafeta, and FedEx in seconds, so you pick the cheapest option without switching tabs or calling anyone. - Avoid manual data entry forever. Use `list_packages` to see your saved standard templates. When creating a shipment, just select 'Medium Box' instead of typing out dimensions again. - Get proactive cost control. Before confirming an order, you can run `get_quotation` to check the rates against current market prices. You know the final shipping cost upfront. - Manage cancellations cleanly. If an order changes or is canceled, call `cancel_label`. This tool voids the label and automatically initiates a refund back to your account balance. - Save time on tracking. Instead of visiting carrier websites for every inquiry, run `get_tracking` once. You get live waypoint telemetry for the customer right in your chat window. ## How It Works The bottom line is: you define the package details once, and the API handles quoting, validation, and outputting the final label. 1. First, tell your agent what you're sending. You run `create_shipment` with the package dimensions and target ZIP code. 2. Next, ask for pricing using `get_quotation`. This step compares rates across various carriers based on the profile created in step one. 3. Finally, if the quote is good, call `create_label`. You get back a unique label file ready to print immediately. ## Frequently Asked Questions **How does the Skydropx API MCP Server handle rate comparisons using get_quotation?** The `get_quotation` tool runs in real-time, pulling rates from multiple carriers (like DHL, Estafeta, and FedEx) simultaneously. It gives you a single comparison report so you can instantly see which carrier offers the best price for your specific package size and ZIP code. **Can I use list_packages to stop re-entering dimensions?** Yes, absolutely. The `list_packages` tool lets you view saved templates of standard boxes. When creating a new shipment, you simply select the template instead of manually inputting length, width, and height. **What if I need to cancel an order after running create_shipment?** You use `cancel_label`. This tool voids any active label associated with that shipment record. It also handles the refund process back to your account balance, so you don't lose money. **Does get_tracking work for all carrier types?** Yes, `get_tracking` is designed to pull live waypoint telemetry from all synced local mail carriers. You just give it the tracking number and it shows you the most current status regardless of who delivered it. **When I use the `create_shipment` tool, how does the API manage authentication and tokens?** The system requires your dedicated Skydropx API token to be bound directly in the context. This ensures that all shipment records you draft are associated with your account's credentials. You must input this token during initial setup before running any commands like `create_shipment`. **Can I use `list_shipments` to retrieve completed or historical orders, not just active ones?** You can refine the output of `list_shipments` using specific date parameters. While it defaults to active shipments, providing a start and end date range allows you to pull records that have been marked as delivered or archived. **If I run `create_package`, what data validation checks does the tool perform on dimensions?** The tool validates package inputs by checking for required physical attributes, including length, width, and height. Make sure you specify the correct unit of measurement (e.g., centimeters or inches) as defined in your account settings to prevent errors. **Before getting a quote, how do I check which local carriers are synced using `list_carriers`?** `list_carriers` pulls an official list of all integrated shipping partners linked to your Skydropx account. This confirms that the carrier you intend to use for `get_quotation` is active and available in your region. **Is it completely safe typing my Skydropx Token Key under the workspace credentials menu?** Yes. Following standard protocol from Vinkius ecosystem, the framework utilizes an implicit `sensitive: true` marker mapping directly blocking its text input masking UI rendering perfectly from eyes. **Can I simply track a parcel giving Claude only the tracking string ID?** Yes! Trigger dynamically `get_tracking` expressing plainly the string, and Skydropx routes heavily providing the array of checkpoints, signatures, and courier state on the payload back to you. **Is the tracking live directly?** Yes, queries real APIs.