Azuga MCP by usefulapi

Read driver scores, trips, driving events, vehicle locations and fault codes in Azuga.

Should I use this

Quality & Safety

A
Description quality
99%
Schema completeness
95%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,774Tokens (tool definitions)
~1.3 KBTypical response size
Significant attention impact (2.17% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "azuga": {
      "url": "https://azuga.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://azuga.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢azuga_get_profile(averageDays, lastSyncTime)

Get the signed-in Azuga user's profile: user name, device, vehicle, fleet score, reward counts and privileges. Also the cheapest authenticated call. Azuga: GET /profile/info.json.

Input Schema

{
  "type": "object",
  "properties": {
    "averageDays": {
      "description": "Days to average the score over (for example 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "lastSyncTime": {
      "description": "Return changes since this epoch-millisecond time.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_driver_scores(averageDays, comparingPool, startIndex, limit)

List driver scores with rank, fleet score, and the speeding, braking, hard-acceleration and idling sub-scores. Per driver, not per group. Azuga: GET /score/list.json.

Input Schema

{
  "type": "object",
  "properties": {
    "averageDays": {
      "description": "Days to average over (for example 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "comparingPool": {
      "description": "Comparison pool id (0 = default).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "startIndex": {
      "description": "Index of the first driver to return.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Maximum drivers to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_trips(fromDate, toDate)

List trips that started and ended between two times, with distance, duration and trip ids. Azuga: GET /trip/info.json.

Input Schema

{
  "type": "object",
  "properties": {
    "fromDate": {
      "type": "string",
      "pattern": "^\\d{10,13}$",
      "description": "Trips starting at or after this epoch-millisecond time."
    },
    "toDate": {
      "type": "string",
      "pattern": "^\\d{10,13}$",
      "description": "Trips ending at or before this epoch-millisecond time."
    }
  },
  "required": [
    "fromDate",
    "toDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_get_trip_events(tripId)

Get the driving events of one trip: hard braking, extreme braking, sudden acceleration, over-speeding and idling, with time, speed, location and fuel. Good first workflow for harsh-driving reviews. Azuga: GET /trip/eventdetail.json (reports host).

Input Schema

{
  "type": "object",
  "properties": {
    "tripId": {
      "type": "string",
      "minLength": 1,
      "description": "Trip id, from azuga_list_trips."
    }
  },
  "required": [
    "tripId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_events(fromDate, toDate, vehicleNames, vehicleIds, groupNames, ...)

List fleet events for vehicles or groups between two times, for example speeding, idling or device events, with sorting and paging. Azuga: POST /events.json (read only).

Input Schema

{
  "type": "object",
  "properties": {
    "fromDate": {
      "type": "string",
      "minLength": 1,
      "description": "Events triggered at or after this time."
    },
    "toDate": {
      "type": "string",
      "minLength": 1,
      "description": "Events triggered at or before this time."
    },
    "vehicleNames": {
      "description": "Vehicle names. Give one of vehicleNames, vehicleIds, groupNames, groupIds.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "vehicleIds": {
      "description": "Vehicle ids. Give one of vehicleNames, vehicleIds, groupNames, groupIds.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "groupNames": {
      "description": "Group names. Give one of vehicleNames, vehicleIds, groupNames, groupIds.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "groupIds": {
      "description": "Group ids. Give one of vehicleNames, vehicleIds, groupNames, groupIds.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "eventType": {
      "description": "Comma-separated event types, for example Speeding,Idling.",
      "type": "string"
    },
    "sortCriteria": {
      "description": "Sort order: ascending or descending (default ascending by event time).",
      "type": "string"
    },
    "startIndex": {
      "description": "Index of the first result to return.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Maximum results per page.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "searchCriteria": {
      "description": "Search one column for a value; ALL searches every column.",
      "type": "string"
    }
  },
  "required": [
    "fromDate",
    "toDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_live_locations(vehicleName, groupName, page)

List the live status and last known location of vehicles, optionally filtered by vehicle or group. Azuga: GET /live/location.json.

Input Schema

{
  "type": "object",
  "properties": {
    "vehicleName": {
      "description": "Vehicle name.",
      "type": "string"
    },
    "groupName": {
      "description": "Group name.",
      "type": "string"
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_get_vehicle_location(username)

Get the last known location of one tracked user (username of the device holder). Azuga: GET /trackee/location/last.json?username=.

Input Schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "minLength": 1,
      "description": "Username of the tracked user."
    }
  },
  "required": [
    "username"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_vehicles(vehicleName, groupName, vehicleIds, includeChildGroups, lastSyncTime, ...)

List vehicles with their names, ids, groups and device details. Filter by name, group or id. Azuga: GET /vehicle/view.json.

Input Schema

{
  "type": "object",
  "properties": {
    "vehicleName": {
      "description": "Vehicle name.",
      "type": "string"
    },
    "groupName": {
      "description": "Group name.",
      "type": "string"
    },
    "vehicleIds": {
      "description": "Comma-separated vehicle ids.",
      "type": "string"
    },
    "includeChildGroups": {
      "description": "true or false: include vehicles of child groups.",
      "type": "string"
    },
    "lastSyncTime": {
      "description": "Return changes since this epoch-millisecond time.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_drivers(type)

List users of the account of one type (default driver), with names, usernames and ids. Azuga: GET /users/view.json?type=.

Input Schema

{
  "type": "object",
  "properties": {
    "type": {
      "default": "driver",
      "description": "User type, for example driver.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_groups(groupName, groupId)

List vehicle and driver groups, with ids and names. Azuga: GET /groups/view.json.

Input Schema

{
  "type": "object",
  "properties": {
    "groupName": {
      "description": "Group name.",
      "type": "string"
    },
    "groupId": {
      "description": "Group id.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_geofences(name, groupName, page)

List geofences (virtual areas), with names and shapes. Filter by name or group. Azuga: GET /geofence/view.json.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Geofence name.",
      "type": "string"
    },
    "groupName": {
      "description": "Group name.",
      "type": "string"
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_landmarks(name, groupName, type, page)

List landmarks (points of interest), with names, types and addresses. Filter by name, group or type. Azuga: GET /landmark/view.json.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Landmark name.",
      "type": "string"
    },
    "groupName": {
      "description": "Group name.",
      "type": "string"
    },
    "type": {
      "description": "Landmark type.",
      "type": "string"
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_get_breadcrumbs(vehicleName, from, to, vin, localTime, ...)

Get the GPS trail of one vehicle between two times, one point per recording, paged. Azuga: GET /breadcrumb/location.json.

Input Schema

{
  "type": "object",
  "properties": {
    "vehicleName": {
      "type": "string",
      "minLength": 1,
      "description": "Vehicle name."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Trail start time."
    },
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "Trail end time."
    },
    "vin": {
      "description": "Vehicle VIN (optional filter).",
      "type": "string"
    },
    "localTime": {
      "description": "Return times in the account's local time zone.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "vehicleName",
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_pairing_history(startTime, endTime, noAssociations)

List which driver was paired with which vehicle or device, between two times. Azuga: GET /users/pairinghistory.json.

Input Schema

{
  "type": "object",
  "properties": {
    "startTime": {
      "type": "string",
      "pattern": "^\\d{10,13}$",
      "description": "Start of the period, epoch milliseconds."
    },
    "endTime": {
      "type": "string",
      "pattern": "^\\d{10,13}$",
      "description": "End of the period, epoch milliseconds."
    },
    "noAssociations": {
      "description": "Set to 1 to include pairings without an association.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "startTime",
    "endTime"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_list_rewards(fromDate, toDate, status)

List driver rewards between two times, with status (pending, processed or all). Azuga: GET /rewards/history.json.

Input Schema

{
  "type": "object",
  "properties": {
    "fromDate": {
      "type": "string",
      "pattern": "^\\d{10,13}$",
      "description": "Start of the period, epoch milliseconds."
    },
    "toDate": {
      "type": "string",
      "pattern": "^\\d{10,13}$",
      "description": "End of the period, epoch milliseconds."
    },
    "status": {
      "description": "Reward status: all, pending or processed.",
      "type": "string"
    }
  },
  "required": [
    "fromDate",
    "toDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢azuga_get_vehicle_diagnostics(vehicleIds, fromDate, toDate)

Get OBD diagnostic trouble codes (DTCs) reported by vehicles in a period, with code, definition, vehicle, location and time. Several vehicles per call. Azuga: POST /diagnostics.json (read only).

Input Schema

{
  "type": "object",
  "properties": {
    "vehicleIds": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Vehicle ids, from azuga_list_vehicles."
    },
    "fromDate": {
      "type": "string",
      "minLength": 1,
      "description": "Start, yyyy-mm-dd HH:mm:ss."
    },
    "toDate": {
      "type": "string",
      "minLength": 1,
      "description": "End, yyyy-mm-dd HH:mm:ss."
    }
  },
  "required": [
    "vehicleIds",
    "fromDate",
    "toDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools