# GoBolt MCP MCP > GoBolt manages e-commerce logistics by letting your AI agent handle global shipping rates, fulfillment orders, and parcel tracking. Connect GoBolt via MCP to get real-time quotes, generate labels, and track any shipment status directly from your chat client. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** parcel-tracking, fulfillment, logistics-automation, shipping-rates, 3pl, supply-chain ## Description This connection links your AI client to GoBolt's entire logistics network. You can automate complex e-commerce tasks without leaving your workspace. Instead of logging into a separate portal for every quote or label, you simply ask your agent—for example, 'What’s the best rate from Chicago to Miami?' Your agent performs the calculation and gives you immediate options. It doesn't stop there; you can tell it to create the order based on that rate, update recipient details if needed, or pull up a full history of an existing tracking number. If your company uses other logistics services, connecting through Vinkius lets you manage all these functions in one place, keeping everything accessible right where you're working. ## Tools ### verify_api_connection Checks that your authentication keys are valid and the connection to GoBolt is active. ### create_shipping_order Sets up and places a new shipment order with GoBolt's system. ### get_merchant_info Retrieves basic details about your connected GoBolt account identity for verification. ### find_fastest_rate Calculates the most rapid delivery method and its corresponding cost. ### get_shipping_labels Downloads the necessary PDF or ZPL file format for printing labels. ### find_cheapest_rate Determines the lowest cost option for shipping between two points. ### get_order_details Pulls specific metadata and current information regarding a given shipping order ID. ### get_shipping_rates Gathers up-to-the-minute cost estimates for a shipment based on physical parameters. ### get_tracking_history Provides a complete timeline of every scan and event recorded for an order. ### track_shipment Quickly gets the current status and estimated delivery date of a shipment. ### list_shipping_orders Retrieves a list summarizing all orders associated with your account. ### modify_shipping_order Changes details, like the recipient's address or package contents, for an existing order. ## Prompt Examples **Prompt:** ``` Get shipping rates from NY to LA for a 2kg package. ``` **Response:** ``` Retrieving rates... I found 3 options: Standard Ground ($12.50, 4 days), Express ($25.00, 2 days), and Overnight ($45.00). Would you like to create an order for any of these? ``` **Prompt:** ``` Track my order with ID 'GBLT-98765'. ``` **Response:** ``` Checking status... Order GBLT-98765 is currently 'In Transit'. It was scanned in Chicago this morning and is estimated to arrive on Thursday by 5 PM. ``` **Prompt:** ``` Find the cheapest shipping rate for a package to Toronto. ``` **Response:** ``` Calculating best rate... The cheapest option for Toronto is 'Postal Surface' at $8.75 CAD with an estimated delivery in 6 business days. ``` ## Capabilities ### Get real-time shipping rates Calculate live costs for a shipment based on the origin, destination, and package dimensions. ### Create fulfillment orders Establish a new shipping order in GoBolt's system, setting up all necessary details before label generation. ### Download shipping labels Programmatically retrieve PDF or ZPL-formatted shipping labels for completed orders. ### Track shipment status View the current location and full event history for any given tracking number or order ID. ### Modify existing order data Update recipient addresses, package details, or other information on a shipping order that hasn't been dispatched yet. ## Use Cases ### The warehouse needs immediate rate comparisons. A planner needs to know if Standard Ground or Express is better for a new product line. They ask their agent, and it uses get_shipping_rates to deliver multiple cost/time options immediately. The planner can then choose the best method. ### Customer support fielding tracking questions. A customer calls about an old order ID. Instead of searching a portal, the agent runs track_shipment and gets the current status instantly, telling the user exactly where the package is now. ### Processing a rush batch of new orders. An operations lead receives 50 manifest files. They use list_shipping_orders to verify which ones are ready, and then run create_shipping_order for all of them sequentially via the agent. ### A shipment needs a minor address correction. The order was placed but the recipient moved. Instead of canceling and re-entering everything, the user uses modify_shipping_order to update only the necessary name or street details while keeping the original order ID. ## Benefits - You get instant rate quotes by calling find_cheapest_rate or find_fastest_rate. Stop manually checking multiple carrier websites for pricing; your agent does the comparison instantly. - Creating orders is simple: Instead of navigating a web form, you tell your agent to create_shipping_order and it handles all the required fields in one go. - Troubleshooting delivery issues gets easier with get_tracking_history. You just ask for the full event log on an order ID and instantly see every scan that happened. - When an address changes, you don't need to restart the process. Use modify_shipping_order to update recipient or package details directly through conversation. - You can generate necessary labels using get_shipping_labels without opening a separate web tool, pulling the PDF right into your chat interface. ## How It Works The bottom line is that it takes multi-step portal workflows and executes them in a single, conversational command sequence. 1. Subscribe to the GoBolt MCP through Vinkius and enter your required Client ID and Secret. 2. Your AI agent accesses the connection, allowing you to request specific logistics functions via natural conversation. 3. The system returns structured data—like calculated rates or a PDF label—directly into your chat environment for immediate use. ## Frequently Asked Questions **How do I get a Client ID and Secret for GoBolt?** Log in to the GoBolt Merchant Portal, navigate to Settings > API, and create a new Service User to generate your Client ID and Secret. **What format should the addresses be in for rates?** Addresses should be provided as JSON objects with 'street', 'city', 'state_province', 'postal_code', and 'country' fields. **Can I track a shipment without a GoBolt ID?** Yes! The 'track_shipment' tool accepts either a GoBolt Order ID or a Carrier Tracking Number. **What label formats are supported?** The API supports 'pdf' for standard printers and 'zpl' for industrial thermal label printers. **How do I use the `verify_api_connection` tool with GoBolt?** The tool confirms your credentials and access scope. Running `verify_api_connection` checks if your MCP client has the necessary permissions to talk to GoBolt, helping you troubleshoot before placing an order. **When should I use both `find_cheapest_rate` and `find_fastest_rate`? ** You use these tools when cost versus speed is a priority. Run `find_cheapest_rate` for budget estimates, then run `find_fastest_rate` to see the quickest options available for that shipment. **How do I modify an existing order using GoBolt's tools?** You call `modify_shipping_order` when you need to change details after placing a shipment. This lets you update things like the recipient name or package dimensions directly through your AI agent. **What is the best way to see all my current orders in GoBolt?** `list_shipping_orders` pulls a complete list of every order ID associated with your account. This is useful for quickly getting an overview and identifying which shipments need attention.