Account & billing

Connect Claude to your fleet (MCP)

Ask an AI assistant where your boats are, and let it answer from live data.

5 min read

Vectra speaks Model Context Protocol, the standard AI assistants use to reach real systems. Connect it and you can ask "is anything off the dock right now?" or "where did Pontoon 22 go on Saturday?" and get an answer from your actual fleet rather than a guess.

Read tools answer straight away. The cut-off has to clear three separate gates before anything physical happens.

Connecting

1
Create an API key
Settings → API keys. Give it only the permissions you want the assistant to have — read-only is a sensible starting point.
2
Add the connector
In your assistant, add a custom MCP server with the URL below and your key in the X-API-Key header.
3
Ask it something
"How is the fleet doing?" is a good first question.

{
  "mcpServers": {
    "vectra": {
      "url": "https://api.vectragps.com/mcp",
      "headers": { "X-API-Key": "vgps_your_key_here" }
    }
  }
}

The endpoint is stateless — no session to keep alive, and no separate MCP credential to manage.

What it can do

Tool	What it answers	Needs
`list_assets`	Every asset with status, speed, battery, last report	devices:read
`fleet_summary`	Counts by state, plus what needs attention	devices:read
`locate_asset`	Where one asset is right now, with a map link	devices:read, gps:read
`get_trail`	Where it has been, distance, top speed, moving time	gps:read
`list_geofences`	Your zones and what each one alerts on	geofences:read
`recent_alerts`	What has alerted recently	alerts:read
`set_storage_mode`	Put an asset into or out of storage mode	devices:write
`set_engine_cutoff`	Cut or restore the ignition relay	commands:write

The safety rails

Cut-off is a physical action on a real vehicle, so it is fenced on three sides. The API key must carry commands:write; the call must pass an explicit confirmation flag, which the assistant is instructed to obtain from you in words first; and the server refuses outright while the asset is moving. An assistant reasoning out loud cannot immobilise a boat.

Give it a read-only key first

A key with only the read permissions cannot change anything at all. Live with that for a week before you decide whether an assistant should be able to act.

Scoped to that key

The assistant sees exactly the account and permissions of the key you gave it. Revoke the key and the connection dies with it.

NextConnect your own JT808 tracker

Something here wrong or missing? Tell us — these pages are maintained by the people who answer the phone.