# 17Track MCP MCP > 17Track MCP gives your agent real-time visibility into global supply chains. Monitor packages across over 1,500 carriers—from USPS and FedEx to specialized regional providers—without visiting a single tracking website. Your client can instantly register new numbers, audit event logs, or get the current status just by asking. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** package-tracking, carrier-integration, logistics-intelligence, shipment-status, real-time-updates ## Description This MCP connects your AI agent directly into global logistics data. You don't need to open 20 different carrier websites; your agent handles that complexity for you. It gives instant access to a package’s history and current location across thousands of providers. Need to track multiple fulfillment centers? Your agent can register them all at once, monitor status changes in real time, and even detect the correct carrier if you only have an ID number. This capability acts like having a dedicated logistics coordinator running inside your chat interface. When connecting through Vinkius, your client gains access to this unified intelligence layer, treating every shipment update as just another piece of data it can process for you. ## Tools ### delete_tracking Removes a specific tracking number record from the managed set of shipments. ### detect_carrier Analyzes a given tracking number to automatically identify the associated logistics carrier. ### get_tracking_info Pulls the complete, real-time status and event log for any active tracking number. ### list_carriers Retrieves a list of all global carriers supported by this MCP connection. ### register_tracking Adds a brand new tracking number to the system, initiating active shipment monitoring. ### stop_tracking Deactivates ongoing monitoring for a tracking number after delivery is confirmed or deemed complete. ### update_tracking_tag Adds or modifies custom metadata tags to a specific shipment record for internal organization. ## Prompt Examples **Prompt:** ``` Register tracking number '123456789' for my order. ``` **Response:** ``` I've successfully registered tracking number '123456789'. I'll now monitor this shipment for you. Would you like to add a custom tag to identify this order? ``` **Prompt:** ``` Get the latest status for my package '123456789'. ``` **Response:** ``` Retrieving tracking info... Your package is currently 'In Transit'. The latest event was 'Arrived at Sort Facility' in Chicago yesterday at 2 PM. Should I notify you of any further changes? ``` **Prompt:** ``` Detect which carrier is handling tracking number 'XY123456789Z'. ``` **Response:** ``` Analyzing tracking format... Based on the number, this shipment is most likely being handled by 'China Post' or 'EMS'. I can use these IDs to register and start tracking it for you now. ``` ## Capabilities ### Check real-time package status Retrieve the current location and latest event history for any given tracking number. ### Identify carrier automatically Determine which logistics company is handling a shipment based on the tracking format or numbers provided. ### Manage tracking records Create, update metadata for, and delete entire tracking records to keep your data clean. ### List supported carriers Get a list of all global logistics providers the system recognizes, confirming coverage before deployment. ## Use Cases ### The fulfillment team needs a status report for 50 packages. Instead of copying and pasting 50 numbers into 10 different carrier websites, the agent runs `get_tracking_info` sequentially for all batch IDs. It then summarizes the results: '23 are In Transit; 5 were delayed at customs; 2 arrived today.' This is pure time savings. ### A customer asks about a package from an unknown region. The agent first uses `detect_carrier` on the provided number. It identifies 'China Post,' and then runs `get_tracking_info`. It delivers the precise status to the user immediately, resolving the inquiry in seconds. ### An internal team needs to audit which carriers are supported. A developer doesn't know if a new partner uses a recognized courier. Running `list_carriers` provides an immediate list of all global providers, letting them check compatibility before integrating the account. ### An order is finalized and needs to be removed from monitoring. Once shipment confirmation hits the system, the agent runs `stop_tracking` and then `delete_tracking`. This cleans up stale data, ensuring only active or required records remain visible. ## Benefits - Instant status checks: Instead of manually visiting carrier sites, your agent uses `get_tracking_info` to pull the latest location and event history immediately. - Build a clean dashboard: Use `delete_tracking` or `stop_tracking` when an order is finished. This keeps your internal records accurate and prevents clutter. - Intelligent identification: If you just have a number, don't guess the carrier. Run `detect_carrier` to get the correct logistics provider ID first. - Bulk management: Use `register_tracking` to onboard hundreds of new numbers at once, automating fulfillment monitoring for large batches of orders. - Data organization: Apply custom tags via `update_tracking_tag`. This lets you categorize shipments (e.g., 'High Value,' 'Returns') without changing the core data. ## How It Works The bottom line is, you never have to manually check an external tracking website again; the information comes directly into your conversation thread. 1. Subscribe to this MCP on Vinkius and enter your 17Track API Key. 2. Connect your preferred agent client (like Cursor or Claude). 3. Ask your agent a question, like 'What's the status for X number?' The system executes the necessary tool calls and returns formatted data. ## Frequently Asked Questions **How does 17Track MCP handle multiple carriers?** It handles them all. This MCP connects to over 1,500 global logistics providers. You don't need to know which carrier is involved; the agent can use `detect_carrier` to figure it out first. **Do I have to update tracking numbers manually?** No. The system handles real-time updates automatically through its connection. You just need to run `get_tracking_info`, and the latest status is returned, even if multiple events happened overnight. **Can I use 17Track MCP for historical data?** Yes. The MCP captures complete event history. When you call `get_tracking_info`, it provides a full log of all milestones, not just the current status. **What if I want to group shipments? Does 17Track MCP support tagging?** Yes, you can use `update_tracking_tag` to add custom metadata. This lets your team organize and filter large batches of shipments by client, department, or project. **How do I get started with 17Track MCP using the `detect_carrier` tool?** You first need an API key from 17Track. Your agent uses this key to authenticate and then calls `detect_carrier` with a tracking number. This step identifies which global provider is handling the shipment before you can get real-time status updates. **When should I use the `delete_tracking` tool in 17Track MCP?** You run `delete_tracking` when a shipment cycle is completely finished and the data needs to be permanently removed. This keeps your dashboard clean and prevents obsolete tracking records from cluttering your active logistics view. **If I need confirmation of all supported providers, should I use the `list_carriers` tool?** Yes, using `list_carriers` provides a comprehensive roster of every global provider 17Track supports. This is useful for auditing your potential operational scope and ensuring you cover all necessary logistics channels. **What happens if I call `get_tracking_info` with an invalid tracking number?** If the format or number is bad, 17Track MCP returns a specific validation error. This immediate feedback tells your agent exactly what needs correcting—whether it's length, character type, or structure. **Can I track packages from different carriers like DHL and FedEx at once?** Yes! 17Track supports over 1,500 carriers. You can register any tracking number, and the `detect_carrier` tool can help identify which provider is handling the shipment. **How do I add a friendly name to a tracking number?** Use the `update_tracking_tag` tool and provide the tracking number along with your desired text in the `tag` parameter. This makes it easier to identify shipments later. **What happens if I don't know the carrier ID?** No problem. You can use the `detect_carrier` tool with the tracking number first. It will return the most likely carrier IDs, which you can then use to register the shipment.