# HyperTrack MCP MCP

> HyperTrack connects your AI agent directly to real-world logistics data. It lets you query device locations, monitor active delivery trips, and manage geofences across an entire fleet. Use it to track field workers, check order status, or list all registered assets without touching a dashboard. This MCP handles the core data streams for last-mile operations.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Tags:** location-tracking, geofencing, last-mile-delivery, fleet-management, trip-monitoring, field-operations

## Description

Managing physical assets is messy work. You need visibility into where everything is—the vehicles, the workers, and the packages they're delivering. HyperTrack gives your agent direct access to that operational feed. Instead of clicking through multiple separate dashboards to check device locations or verify a worker’s current status, you ask your AI client to look it up. It pulls data on active trips, lists all registered devices, and confirms if an order is still within its designated service zone by checking geofences.

This means your agent can manage the entire lifecycle of field operations—from initial assignment to final delivery confirmation—all from a natural conversation. When you connect this MCP via Vinkius, your AI client gains a comprehensive view of all logistics data streams. You get immediate status reports on orders and workers alike, making dispatching and troubleshooting faster than ever.

## Tools

### get_device
Retrieves detailed records for one specific tracking unit.

### get_geofence
Gets the boundary details for a particular virtual zone.

### get_order
Pulls all data related to a single delivery or service order.

### get_trip
Retrieves the full history and details for one specific journey.

### get_worker
Gets the current operational profile for a named field employee.

### list_devices
Returns an array of every device currently registered in the system.

### list_geofences
Lists all configured virtual boundaries and their names.

### list_orders
Provides a bulk list of all existing orders, useful for reporting.

### list_trips
Lists every recorded trip ID and its summary data.

### list_workers
Returns a complete roster of all workers associated with the system.

## Prompt Examples

**Prompt:** 
```
List all devices currently being tracked in HyperTrack.
```

**Response:** 
```
I'll fetch the list of your active devices.
```

**Prompt:** 
```
Show me the details for trip ID 'abc-123'.
```

**Response:** 
```
I'll retrieve the detailed information for that trip.
```

**Prompt:** 
```
Check for any active geofences in the system.
```

**Response:** 
```
I'll look up the list of configured geofences for you.
```

## Capabilities

### Check device details
Retrieve specific information for any tracked asset using its ID.

### List all devices
Get a complete roster of every registered tracking device in the system.

### Monitor active trips
Fetch detailed records for ongoing delivery or service routes, including start and end points.

### View geofence boundaries
Get details on specific virtual boundaries set up to monitor restricted zones or service areas.

### Track worker status
Retrieve the current operational information and location of any assigned field employee.

### Check order specifics
Get all necessary details about a specific delivery or service order.

## Use Cases

### Incident response after hours
A warehouse manager needs to know which equipment is near a specific zone boundary right now. They ask their agent, 'Which devices are closest to Geofence X?' The agent calls `get_geofence` and then iterates through the list of active assets to pinpoint exactly where they need to send support.

### Daily fleet readiness check
A dispatcher needs an overview of all workers starting their shift. They ask, 'List me all available staff.' The agent uses `list_workers` and then checks the associated statuses against the latest data from `list_trips`, flagging anyone who hasn't logged in.

### Post-delivery reconciliation
A finance analyst needs to confirm if all items for a specific job were completed. They ask, 'Show me the full details for order ABC-456.' The agent calls `get_order`, pulling every associated detail point into one readable report.

### Auditing asset deployment
An auditor needs to know how many devices are currently active. They prompt, 'Count all tracked assets.' The agent uses `list_devices` and provides the count instantly, saving hours of database querying.

## Benefits

- Immediate status checks: Instead of navigating to the trip dashboard, you ask your agent for details on a specific journey ID using `get_trip`, getting instant confirmation of its current phase.
- Full asset visibility: Use `list_devices` to generate an immediate inventory report of every tracking unit without manual querying or filtering in a UI.
- Boundary enforcement: You can programmatically check if assets are restricted by calling `get_geofence` and comparing it against the device's coordinates, ensuring compliance before proceeding.
- Worker lifecycle management: Quickly verify employee status using `list_workers` to ensure all necessary personnel are accounted for before dispatching a team.
- Order tracking reliability: By running `list_orders`, you get an up-to-date list of pending jobs, allowing your agent to prioritize the next steps automatically.

## How It Works

The bottom line is: it lets your AI client query complex, live operational data streams without needing manual API construction.

1. Your AI client sends a request, specifying the type of data needed (e.g., 'Show me devices in Zone A').
2. The HyperTrack MCP intercepts this call and executes the necessary underlying API calls to gather raw logistics data.
3. The agent returns structured, contextualized results—for instance, listing all active trips or retrieving a specific order's full history.

## Frequently Asked Questions

**How do I check if my device is in a restricted area using HyperTrack MCP?**
You must first use `list_geofences` to see all mapped zones. Then, you call `get_geofence` and pass the coordinates of your device (retrieved via `get_device`) to confirm if it's inside or outside the boundary.

**What is the best way to get a list of all active workers?**
Use the `list_workers` tool. This gives you every worker ID currently registered, which you can then use in combination with `get_worker` if you need specific status details on a subset of those users.

**Can I see all pending orders at once using HyperTrack MCP?**
Yes, running the `list_orders` tool provides an immediate list of every order ID. You can then follow up by calling `get_order` on a specific ID to get full details.

**What if I need historical data for a trip?**
You should use the `list_trips` tool first to see available IDs. Then, call `get_trip(ID)` to pull the detailed logs and history associated with that specific journey.

**When I use the `get_device` tool, what information does it retrieve about a specific unit?**
It returns comprehensive details for that single device. You get its current operational status, last recorded location coordinates, and associated metrics without needing to list all devices first.

**How do I check the parameters of a defined area using the `get_geofence` tool?**
The tool provides the exact geographic boundaries for that geofence. You can confirm its shape, whether it's active, and any associated metadata before your agent uses it to monitor movement.

**If I run `get_order` with an ID, what specific data points about a delivery can I pull?**
You retrieve the full order manifest. This includes items listed, customer contact details, and the current processing status of the entire shipment.

**What does `get_worker` return regarding an assigned field employee?**
It gives you all stored information for that worker, including their contact credentials and designated role. Use this to validate who is on site before your agent dispatches tasks.

**How do I get HyperTrack API credentials?**
You can find your Account ID and Secret Key in the HyperTrack dashboard under the Setup page.

**Which version of the API is used?**
This MCP uses HyperTrack API v3, the latest version for location tracking and operations.

**Can I track individual workers?**
Yes, the list_workers tool provides access to field worker metadata and their current tracking status.