# GPS Insight MCP by usefulapi

> GPS Insight MCP by usefulapi is an MCP server. Read vehicles, positions, idle time, fault codes, driving scores and alerts in GPS Insight. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/gps-insight/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/gps-insight
- **MCP Registry name:** io.usefulapi/gps-insight
- **Listing updated:** 2026-11-13

## About

Read vehicles, positions, idle time, fault codes, driving scores and alerts in GPS Insight.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gps-insight https://gps-insight.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gps-insight.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gps-insight": {
      "url": "https://gps-insight.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gps-insight": {
      "type": "http",
      "url": "https://gps-insight.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gps-insight": {
      "serverUrl": "https://gps-insight.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gps-insight": {
      "type": "http",
      "url": "https://gps-insight.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `gpsinsight_list_vehicles`: List the vehicles on the account with their ids, VINs and labels. Use details=1 for all columns, or a comma list such as make,model,odometer. Good first call to find a vehicle. GET /v2/vehicle/list.
- `gpsinsight_read_vehicle`: Read the record of one vehicle: id, VIN, label and serial number. GET /v2/vehicle/read.
- `gpsinsight_vehicle_location`: Get the latest position of one vehicle: address, landmark, speed, heading, ignition, odometer, driver and inputs. GET /v2/vehicle/location.
- `gpsinsight_vehicle_history`: Get the recorded positions of one vehicle between two times, with speed, ignition and odometer. GET /v2/vehicle/history.
- `gpsinsight_vehicle_idle_detail`: List the idle periods of one vehicle on one day, with place, duration and fuel used while idling. GET /v2/vehicle/idledetail.
- `gpsinsight_vehicle_dtc`: List the diagnostic trouble codes (DTC) one vehicle reported on one day, with counts and times. GET /v2/vehicle/dtc.
- `gpsinsight_vehicle_scorecard`: Get the driving score of one vehicle for a period, with daily scores and the events behind them. GET /v2/vehicle/scorecard.
- `gpsinsight_vehicle_fuel_card_transactions`: List the fuel card transactions of one vehicle between two days. GET /v2/vehicle/fuelCardTransactions.
- `gpsinsight_list_vehicle_groups`: List the vehicle groups with their ids and vehicle counts. GET /v2/vehiclegroup/list.
- `gpsinsight_list_drivers`: List the drivers on the account with their ids and contact fields. GET /v2/driver/list.
- `gpsinsight_list_users`: List the portal users on the account with their usernames and names. GET /v2/user/list.
- `gpsinsight_list_landmarks`: List the landmarks (named places with a radius or polygon), optionally one landmark group. GET /v2/landmark/list.
- `gpsinsight_list_alerts`: List the alert types configured on the account and whether each one is active. GET /v2/alert/list.
- `gpsinsight_alert_history`: List alert events, for one vehicle or one alert id, from the last alert_minutes_age minutes. GET /v2/alert/history.
- `gpsinsight_reverse_geocode`: Turn a latitude and longitude into a street address and city. GET /v2/geocode/reverse.

## FAQ

### How do I add GPS Insight MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http gps-insight https://gps-insight.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/gps-insight-mcp-by-usefulapi
