# Track-POD MCP

> Track-POD connects your delivery account to any AI client. Use it to list orders, monitor active routes, create new unscheduled tasks, and query driver availability for last-mile logistics management. It gives agents direct access to real-time fleet data.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** delivery-management, route-optimization, proof-of-delivery, fleet-tracking, logistics-automation, order-tracking

## Description

You wanna manage last-mile logistics, right? You need a solid connection to your delivery account, and this is it. The Track-POD MCP Server connects your preferred AI client straight into your fleet's operational data. It gives you direct access to real-time tracking info—you can list every job on the books, check which trucks are out there, or even schedule an unscheduled run. Basically, it makes sure your agent knows exactly where everybody is and what needs doing.

### Order Management Details

Need to know about a specific delivery? Just pass the unique identifier into `get_order_by_number`, and you'll pull up all the detailed metadata on that job. You get the status, who it’s assigned to, and the expected drop-off time—all in one go. Wanna see everything currently active or planned? Use `list_orders` to grab a complete list of every single delivery job tracked by the platform. If you need to build an unscheduled task on the fly, you can run `create_order`, providing both the client name and the physical address for the new drop-off point.

### Checking Out Your Fleet Status

Figuring out where your assets are is half the battle. You can use `list_drivers` to get a list of every registered driver in the system, so you know who's available. Need to check the equipment? Run `list_vehicles` and it gives you a directory listing of every truck assigned to the fleet. To track where all the action is happening, use `list_routes`, which pulls up details on every active or planned delivery path for total oversight.

### System Health Check

Before you start running complex commands, you gotta make sure everything's talking right. Run `test_api_connection` first. It validates your API key and confirms that the server connection is working correctly with your credentials. You can also pull up a full list of all available resources by checking the status using `list_vehicles`, which keeps track of every unit you’ve got on the road.

This server gives your agent more than just data; it lets it *act*. It helps you coordinate multiple moving parts—the job, the person, and the truck—all from one place. You'll use these tools to check driver availability against outstanding orders, or create a new urgent task immediately when something changes out there on the ground.

## Tools

### create_order
Creates a new delivery order by requiring an order number and client name.

### get_order_by_number
Retrieves full details for one specific order using its unique identifier.

### list_drivers
Returns a list of all registered drivers in your system.

### list_orders
Pulls a complete list of every order currently tracked by the platform.

### list_routes
Lists all active or planned delivery routes for monitoring and oversight.

### list_vehicles
Provides a directory listing of every vehicle assigned to the fleet.

### test_api_connection
Validates your API key and confirms that the server connection is working correctly.

## Prompt Examples

**Prompt:** 
```
List all active delivery routes in my account.
```

**Response:** 
```
I've retrieved your routes. You have 3 active delivery paths: 'Downtown Morning', 'North Sector Express', and 'Warehouse Transfer'. Which one would you like to monitor?
```

**Prompt:** 
```
Show me the details for order #ORD-8823.
```

**Response:** 
```
I've fetched the metadata for order #ORD-8823. The status is 'In Transit', assigned to driver 'Mike Miller' on the 'Downtown Morning' route. The expected delivery time is 11:30 AM.
```

**Prompt:** 
```
Create a new order #ORD-9902 for 'Tech Solutions' at '123 Main St'.
```

**Response:** 
```
Success! Order #ORD-9902 has been created for 'Tech Solutions' at the provided address. It is currently unscheduled. Would you like me to check the driver availability for dispatching?
```

## Capabilities

### Get Specific Order Details
Pass an order number to pull detailed metadata on a job's status, assignment, and expected delivery time.

### Create New Orders
Build unscheduled tasks by providing the client name and physical address for a new delivery job.

### List All Deliveries & Routes
Retrieve comprehensive lists of all existing orders or monitor every active/planned route in your system.

### Check Fleet Status
Pull current data on available drivers, vehicles, and the overall operational status of your entire fleet.

### Test API Connection
Run a mandatory health check to confirm that the server is connected and ready for use with your provided credentials.

## Use Cases

### The Morning Dispatch Check
A dispatcher needs to know who's available today for a rush job. They ask the agent, which immediately runs `list_drivers` and filters by status. The agent replies with three drivers ready to go, saving 15 minutes of checking spreadsheets.

### Tracking an Unknown Shipment
A client calls asking about order #ORD-7890. Instead of waiting for a human to check the database, the agent runs `get_order_by_number` and reports back: 'In Transit, assigned to Mike Miller, ETA 11:30 AM.' Problem solved instantly.

### Planning Tomorrow's Runs
The operations team wants to see all jobs scheduled for the next day. They run `list_orders`, getting a summarized list of required deliveries, which they then use to build out routes via manual input.

### Building a New Service Area
A manager needs to test if their new zip code is covered. They first run `list_vehicles` to check asset capacity and then use `create_order`, providing the client data, setting up the job before any physical dispatch happens.

## Benefits

- **Get real-time status on any job.** Instead of logging into the portal, simply ask your agent to `get_order_by_number` and get instant metadata (status, assigned driver, ETA).
- **Coordinate dispatch instantly.** Need a new run? Use `create_order` in conversation. The system handles generating the task record without you touching a web form.
- **See your entire fleet at a glance.** Run `list_drivers` or `list_vehicles` to check availability across all assets before planning routes, eliminating manual roster checks.
- **Monitor delivery paths easily.** Use `list_routes` to see if a planned route is active or stalled. It lets you oversee the network without needing map software.
- **Build trust with simple validation.** Always run `test_api_connection` first. This confirms your API key and connection are live before you try running any critical commands.

## How It Works

The bottom line is you manage your entire delivery operation by talking to your AI client, not clicking through dashboards.

1. Subscribe to this server on Vinkius and enter your Track-POD API Key.
2. Your AI agent uses the key to authenticate and connect to the logistics backend.
3. You ask your agent to perform a task (e.g., 'List all routes for tomorrow') using natural language.

## Frequently Asked Questions

**How do I check if my API key works with Track-POD MCP Server?**
You run the `test_api_connection` tool. This immediately verifies your credentials and confirms that the server is connected to your account without needing any other setup.

**Can I list all my orders using the list_orders tool?**
Yes, running `list_orders` pulls a complete list of every job. This is useful for getting a high-level view before filtering down to specific tasks.

**What if I want to create a new order? Do I need the client name?**
Yes, `create_order` requires both an order number and the client's name. You must provide both pieces of information for the task to be successfully logged.

**Does list_routes show me planned routes or just active ones?**
It lists both. You can use it to monitor currently running paths, or you can check future planning by listing all potential delivery paths.

**How do I use the `get_order_by_number` tool?**
You provide a specific order number, and the tool returns full metadata for that single record. This is perfect when you need quick details—like status or assigned driver—without having to sift through an entire list of orders.

**What data does the `list_drivers` tool provide?**
It returns a directory of all drivers and their vehicles. You'll get key details like the driver's name, assigned vehicle ID, and current availability status. This helps dispatchers quickly gauge overall manpower distribution.

**Does `list_vehicles` show me every asset, even if it’s not currently on a route?**
Yes, the tool gives you a full inventory of every vehicle registered in your system. You get details on the asset ID and its make/model, regardless of whether it's active or sitting idle.

**If I run any tool and receive an error, what should I check first?**
First, use `test_api_connection` to confirm your API key is valid. If that passes, the issue is likely rate limiting; repeatedly calling the same function too fast will trigger a temporary block.

**Can I see all the orders for a specific client?**
Yes! Use the `list_orders` tool. While it returns the full list, you can ask the AI agent to filter or identify all records matching a specific client name.

**How do I create a new delivery order via AI?**
Use the `create_order` tool. You'll need to provide an Order Number, the Client Name, and an optional delivery address to register the new task in Track-POD.

**Is it possible to list all the drivers currently available in the fleet?**
Absolutely. Use the `list_drivers` query. The agent will retrieve the complete directory of delivery drivers associated with your account, helping you coordinate assignments.