# Ship24 MCP > Ship24 tracks packages from over 1,200 global carriers using one universal API. It lets you manage logistics and retrieve real-time delivery status for any tracking number—whether it's a single package or thousands of bulk shipments. Use your AI agent to search, create trackers, and get live updates without ever visiting a carrier website. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** parcel-tracking, multi-carrier, logistics-api, real-time-tracking, delivery-status, supply-chain ## Description You gotta manage global logistics tracking? Ship24 handles it through one universal API, letting your AI client talk to over 1,200 carriers and ditch those endless carrier websites. This server gives you full control over multi-carrier movements—whether you're dealing with a single package or thousands of bulk shipments. **Finding Package Status** Your agent lets you look up any tracking number using `find_tracker_by_number`, giving you an immediate status check just from the number and carrier code. To get the most current, minute-by-minute location updates, run `get_live_tracking`. If you need the full story—every milestone and detailed result for a shipment—you use `get_tracking_results`. You can also confirm how robust the whole setup is before starting work by checking the server's connection health with `get_api_status`. **Managing Shipments and Tracking Groups** Need to keep tabs on multiple packages? The server lets you create, list, and delete groups of trackers. You start monitoring batches using `create_bulk_trackers`, which is huge for high-volume operations; later, you can audit or view all those large groups with `list_bulk_trackers`. For single shipments, you initialize tracking on one specific package with `create_tracker` and keep a record of everything active by calling `list_active_trackers`. If things change, don't sweat it—you modify descriptive metadata associated with an existing tracker ID using `update_tracker_info`, keeping your records clean. **Identifying Carriers and Setup** Don’t know which carrier code you need? You can find the correct providers by listing every supported shipping company with `list_couriers` or narrowing down your search for a specific name or code using `search_couriers`. This ensures you get the right provider before attempting any tracking lookups. **Maintaining and Closing Tracks** When a shipment is finished, you tell the system to stop monitoring it via `delete_tracker`. These tools give you end-to-end control over your entire logistics pipeline. You're not just checking status; you're building an automated coordination layer for your whole global network. ## Tools ### create_bulk_trackers Starts monitoring multiple packages at once for high-volume operations. ### create_tracker Initializes tracking on a single specific package. ### delete_tracker Stops monitoring a shipment that is no longer relevant to the workflow. ### find_tracker_by_number Performs an immediate lookup of package status using only a tracking number and carrier code. ### get_api_status Checks the connection health and operational status of the Ship24 API server. ### get_live_tracking Retrieves the most current, minute-by-minute update for a package's location or status. ### get_tracking_results Fetches detailed tracking results and the full milestone history for any given shipment. ### list_active_trackers Retrieves a list of all shipments currently being tracked by the user's account. ### list_bulk_trackers Lists and audits all large groups (batches) of shipments under monitoring. ### list_couriers Retrieves a list of every supported shipping carrier available through the API. ### search_couriers Searches for specific carrier names or codes to identify the correct tracking provider. ### update_tracker_info Modifies descriptive information (metadata) associated with a specific tracker ID. ## Prompt Examples **Prompt:** ``` Track the package with tracking number '1234567890' using Ship24. ``` **Response:** ``` I've retrieved the tracking status. Your package is currently 'In Transit' in London, UK, and was last updated 2 hours ago. Would you like the full milestone history? ``` **Prompt:** ``` Find the carrier code for DHL. ``` **Response:** ``` Searching couriers... I found the identifier 'dhl' for DHL Express and 'dhl-global-mail' for DHL Global Mail. Which one would you like to use for tracking? ``` **Prompt:** ``` List all my active trackers in Ship24. ``` **Response:** ``` Retrieving your trackers... You currently have 3 shipments being monitored. The most recent is tracker 'TRK-9921' (Out for delivery). Would you like to see details for the others? ``` ## Capabilities ### Find Package Status You can ask the AI to look up any tracking number and get its current status or full historical milestones. ### Manage Shipment Groups The server lets you create, list, and delete groups of trackers (bulk shipments) for large-scale monitoring efforts. ### Identify Couriers You can search or list supported carriers to find the correct codes needed before tracking any package. ### Update Tracker Data The agent lets you modify metadata associated with an existing tracker record, keeping your records accurate. ### Check API Health You can run `get_api_status` to confirm the server's connectivity and operational status before starting a workflow. ## Use Cases ### The Urgent Customer Inquiry A customer calls asking about an international delivery they bought last week. Instead of asking the agent to 'search carriers' first, you just ask: 'What is the status for 99XYZ?' The agent uses `find_tracker_by_number` and immediately provides the live update without needing any extra steps or context switching. ### The Batch Audit At the end of a quarter, you need to audit all shipments that were monitored but are now complete. You run `list_bulk_trackers` and get a clean list of every shipment group, allowing you to check performance metrics across dozens of different carriers instantly. ### The New Partner Onboarding A new e-commerce partner joins your network using an unfamiliar carrier. You don't know their code. You run `search_couriers` for the company name, get the required codes, and then use those codes to successfully start tracking packages with `create_tracker`. ### Troubleshooting a Data Gap You suspect some of your shipment data is stale. You run `list_active_trackers`, see which ones are running, and then tell the agent to 'Update the metadata for these 5 trackers.' This uses `update_tracker_info` to ensure records reflect current operational details. ## Benefits - Instantly get detailed status updates for *any* package. Instead of having to visit multiple sites, simply ask the agent to 'Get tracking results' using `get_tracking_results`, and you get the full history right there. - Manage high volumes with dedicated tools. Use `create_bulk_trackers` to start monitoring hundreds of items at once, which is a huge time saver compared to creating trackers one by one. - Zero friction carrier lookup. If you don't know the code for a shipper, run `search_couriers`. It tells you exactly what identifier to use before you even try tracking. - Audit your entire system health quickly. Run `get_api_status` at the start of any session. This confirms the connection is live and ready to go, saving time when an API fails. - Control all shipments with simple commands. Use `list_active_trackers` to see what's currently running in your system, or `delete_tracker` if a shipment falls out of scope. ## How It Works The bottom line is that once you plug in your API key, your AI client becomes a global logistics desk for tracking anything shipped anywhere. 1. Subscribe to the MCP Server, then input your Ship24 API Key into your AI client. 2. Ask your agent to perform an action—for example, 'Find tracking status for 1Z999XYZ'. 3. The agent calls the appropriate tool (like `find_tracker_by_number`), pulls the data, and presents you with a natural language summary. ## Frequently Asked Questions **How do I find the correct carrier code for Ship24? ** You use the `search_couriers` tool. It lets you search by name (like 'FedEx' or 'Correios') and returns the exact, usable identifier required to proceed with any tracking function. **Can I monitor a huge list of shipments using create_bulk_trackers? ** Yes. `create_bulk_trackers` is built for high volume. It lets you initialize monitoring status across large sets of packages, keeping your whole delivery pipeline synchronized. **What if my package number format is weird? Should I use find_tracker_by_number? ** Yes. `find_tracker_by_number` runs an instant lookup using only the tracking number and carrier code. It’s ideal for quick, one-off checks when you don't need to start a full monitoring cycle. **Do I have to manually update info every time? Can I use update_tracker_info? ** No. If your records need manual details added—like noting the client name or customs value—you can run `update_tracker_info` to add that metadata without changing the tracking status. **What does the `get_api_status` tool report?** It confirms your API key and connection health. Use this first to validate that your credentials are active and Ship24 is reachable before running any tracking jobs. **Is there a difference between using `get_live_tracking` and `get_tracking_results`?** Yes, they provide different views. `get_tracking_results` gives the comprehensive historical record and milestones. `get_live_tracking` focuses on the absolute latest location update and current status. **How do I stop monitoring a package using `delete_tracker`?** The `delete_tracker` tool immediately terminates tracking for that shipment ID. Use this when you no longer need updates to free up resources or prevent unnecessary API calls. **What specific data does the `get_tracking_results` function return?** It returns a detailed record of the package's journey, including every recorded milestone and location change. This is key for understanding the full delivery timeline, not just the current status. **Can my AI automatically find the tracking status of a specific package just by providing the tracking number?** Yes! Use the `get_live_tracking` tool with the tracking number. Your agent will respond with the real-time status, carrier info, and current location in seconds. **How do I search for a specific carrier code (e.g. FedEx or DHL)?** Simply ask the agent to run the `search_couriers` action with the name of the carrier. It will retrieve the correct identifier for that provider. **How do I find my Ship24 API Key?** Log in to your Ship24 account, navigate to the **Dashboard**, and select **API** to copy your unique secret API key.