# Cartrack MCP > Cartrack lets you manage your entire fleet operation through natural conversation. Connect it to any AI client to get real-time vehicle location, monitor fuel consumption, and analyze trip history without opening a dashboard. It gives you full control of telematics data directly from your chat interface. ## Overview - **Category:** iot-hardware - **Price:** Free - **Tags:** telematics, gps-tracking, vehicle-monitoring, fleet-optimization, driver-safety, real-time-data ## Description You connect your company's Cartrack account to this MCP. Your agent then handles all the complex data pulling, letting you talk about your fleet like you're talking to a dispatcher on the phone. You can ask where every vehicle is right now and get its current status, whether it's idling or moving. Need to know if any truck hit a restricted zone? Just ask, and the agent checks for alerts. It even pulls historical data, so you can audit past trips or check fuel usage across the whole fleet instantly. This capability makes complex operational reporting simple; you just talk to your AI client instead of navigating dozens of tabs. Because this MCP is hosted on Vinkius, it connects all that critical logistics data into one place for any compatible agent to read. ## Tools ### get_fuel_status Retrieves the current fuel level and consumption metrics for a specific vehicle. ### get_vehicle_position Provides the exact, real-time GPS coordinates and status for a given vehicle. ### get_vehicle_details Fetches comprehensive identifying information about one particular vehicle in the fleet. ### list_fleet_alerts Returns a list of recent operational alerts across the entire fleet, such as speeding events or idling warnings. ### list_fleet_drivers Generates a manifest listing all drivers currently registered in the system. ### list_geofences Lists every defined geographical boundary (geofence) used to manage operational areas. ### list_vehicle_trips Retrieves the historical trip data, including start and end times, for a specified vehicle. ### list_vehicles Provides an inventory of every single vehicle registered within the entire fleet system. ## Prompt Examples **Prompt:** ``` Where is vehicle with registration 'ABC-123' currently? ``` **Response:** ``` Checking location for 'ABC-123'... The vehicle is currently located at 123 Main Street, Johannesburg, and its status is 'Idling'. ``` **Prompt:** ``` Show me the trip history for vehicle ID 999 for yesterday. ``` **Response:** ``` Retrieving trips for vehicle 999... I found 4 trips yesterday. The longest was 45km, starting at 08:30 AM and ending at 09:45 AM. Would you like to see the route details? ``` **Prompt:** ``` Check the fuel levels for my entire fleet. ``` **Response:** ``` Scanning fleet fuel status... Most vehicles are above 70%. However, vehicle 'XYZ-789' is low at 12%. Should I notify the driver? ``` ## Capabilities ### Check real-time location Determine the current GPS position and status for any vehicle in your managed fleet. ### Audit fleet assets Get a complete list of all registered vehicles or all active drivers on site. ### Analyze trip history Retrieve detailed logs and metrics for specific vehicle trips, such as routes taken or total distance driven. ### Monitor fuel status Get the current fuel level and consumption rate for a single vehicle to flag low stock. ### Review operational alerts List all recent events, like speeding incidents or boundary violations, that occurred across the fleet. ### Manage boundaries Access details on every configured geofence to confirm operational zones. ## Use Cases ### Identifying immediate risks on a job site The Safety Officer asks, 'List all active alerts for the last hour.' The agent runs `list_fleet_alerts` and reports back that two vehicles were speeding near the construction zone. This allows the officer to intervene immediately without calling dispatch. ### Planning a multi-stop route The Logistics Coordinator asks, 'Which vehicles are available today?' The agent runs `list_vehicles` and then checks the fuel for each one using `get_fuel_status`. If four trucks have enough gas and no alerts, the routes can be assigned immediately. ### Investigating a delay The Dispatcher asks, 'What happened with truck 45 yesterday?' The agent runs `list_vehicle_trips` for that ID. It shows four trips were completed, and the last one started at 3 PM, confirming its location was where it needed to be. ### Verifying operational boundaries The Fleet Manager asks, 'Do we have any restricted zones defined?' The agent runs `list_geofences` and lists all boundary IDs. This confirms the operational scope before planning a new route for the entire fleet. ## Benefits - You check real-time status without complex queries. You simply ask your agent to determine the current GPS position of a vehicle, getting immediate data on its exact whereabouts. - Stop manually checking dashboards. By calling `list_fleet_alerts`, you instantly get a summary of all recent incidents—speeding, idling, or boundary breaches—in one chat reply. - You audit past operations easily. Use `list_vehicle_trips` to pull up an entire history for a vehicle, giving you the necessary data to calculate total mileage and usage over weeks. - Fuel management is simple. Instead of opening multiple reports, asking your agent to use `get_fuel_status` tells you instantly if a truck needs refueling before it even hits the road. - You get full visibility into boundaries. Reviewing all configured zones via `list_geofences` ensures every asset operates within its defined legal or operational area. ## How It Works The bottom line is, you're using natural language to execute complex database queries about physical assets. 1. Subscribe to this MCP and input your Cartrack credentials (Username, Password, API Base URL). 2. Your AI client authenticates the connection and prepares the telematics data streams. 3. You prompt your agent with a request—like 'Where is vehicle X and how much fuel does it have?'—and receive an immediate answer. ## Frequently Asked Questions **How do I check if any vehicle is speeding using the Cartrack MCP?** You list recent alerts by asking your agent to run `list_fleet_alerts`. This tool compiles all event data, letting you see every instance of speeding or other violation across the entire fleet. **Can I get the current location and fuel status at the same time with Cartrack MCP?** Yes. You prompt your agent to check a specific vehicle's position using `get_vehicle_position` and combine that request with `get_fuel_status`. The AI client handles running both calls and presenting one cohesive answer. **What if I need trip details for only one day?** Use the `list_vehicle_trips` tool. You simply specify the vehicle ID and date range in your prompt, and the agent pulls the historical route data you need. **Does Cartrack MCP list every asset or just what's currently moving?** It lists both. Use `list_vehicles` to get a full inventory count of all assets. For active status, use the agent to check the position using `get_vehicle_position`. **What credentials do I need to run a basic command like `list_vehicles` using Cartrack MCP?** You'll need your Cartrack Username, API Key, and the base URL. The initial setup requires these three pieces of information for secure connection to the system. **Are there any rate limits if I frequently run the `get_vehicle_position` tool for multiple vehicles?** Yes, excessive calls might trigger throttling. We recommend implementing a pause of at least five seconds between consecutive location checks to maintain service stability. **When using the `get_vehicle_details` tool, can I filter or select specific pieces of information?** Yes. The MCP allows you to specify required fields in your prompt (e.g., 'Only provide the VIN and model year'). This keeps the output clean and focused on what you need. **Does receiving no output when running `list_fleet_alerts` mean the fleet is operating normally?** Not necessarily. Zero alerts means nothing was logged, but it could also point to a connectivity issue or that active alert monitoring hasn't been configured yet. **Can I see where a specific vehicle is right now?** Yes! Use the `get_vehicle_position` tool with the vehicle's registration or ID. The agent will return the latest GPS coordinates and the formatted address. **How do I check if there were any speeding alerts today?** Use the `list_fleet_alerts` tool. Your agent will fetch recent events, allowing you to filter for speeding incidents and see which vehicles and drivers were involved. **Where do I find my API Base URL?** The URL depends on your region. Common ones include `https://fleetapi-za.cartrack.com/rest/` for South Africa or `https://fleetapi-sg.cartrack.com/rest/` for Singapore. Check the Cartrack Developer Portal for your specific region.