MCP

SafarTrak MCP server

Connect Claude, ChatGPT and other MCP-compatible AI apps to live SafarTrak data: vehicles, cold-chain temperatures, alerts, trips and utilisation, with approval for every change.

Overview

The SafarTrak MCP server implements the Model Context Protocol, an open standard that lets AI assistants discover and call external tools. It exposes SafarTrak fleet data as tools, so any MCP-compatible client can answer questions about your fleet in plain language. No SQL, API code or report exports are needed.

Your AI app is the front end, the MCP server is the secure bridge, and your SafarTrak account stays the source of truth. Every request runs with your company's access, on live data.

Server URL
https://mcp.safartrak.com/mcp
Transport
Streamable HTTP
Sign-in
OAuth (SafarTrak portal login or API key), or API key headers
Changes
Trip schedules only, with your approval

Capabilities & tools

25 tools: 21 that read and 4 that change trips. Read tools run without interrupting you. Write tools are only available if you allow them when connecting, and your AI app asks you to approve every change.

Vehicles & live location

Vehicles & live location tools
TypeToolWhat it does
ReadFleet summaryVehicle counts by live status: moving, idle, offline and no GPS.
ReadList vehiclesVehicles with status, speed, driver, vendor, client and city. Filter by status, fleet group, category, type or registration number.
ReadVehicle detailsLive details for one vehicle.
ReadLive locationsLatest position of every vehicle.
ReadRoute historyDistance, running and stopped time, and every run and stop for a day or date range.

Cold chain & alerts

Cold chain & alerts tools
TypeToolWhat it does
ReadTemperature statusCurrent reefer temperature against each vehicle's range, with breaches and how long they lasted.
ReadTemperature historyReadings over time for one vehicle, with a compliance summary.
ReadAlertsAlert summary, alert types and alert events by vehicle, type, severity and time.

Trips

Trips tools
TypeToolWhat it does
ReadTrip summary & listTrips by status, with checkpoints completed and temperature-abuse flags.
ReadTrip detailsOne trip's stops, load-in and load-out events and temperature log.
WriteCreate tripCreate a trip schedule for a vehicle with its route, timings and temperature range.
WriteUpdate tripChange a trip's vehicle, driver, times, points or temperature range.
WriteMark deliveredClose a trip as delivered.
WriteCancel tripCancel a trip schedule.

Analytics & utilisation

Analytics & utilisation tools
TypeToolWhat it does
ReadFleet analyticsDistance, running and idle hours and fleet score for a period.
ReadDistance trendDaily distance for the fleet, ready to chart.
ReadVehicle rankingHighest or lowest vehicles by distance, with change against the previous period.
ReadUtilisationKilometre and hour utilisation against contract by vehicle and vendor, with optimisation flags.
ReadLookupsFleet groups, vendors, cities, vehicle types and categories for filtering.

Ready-made prompts are built in: daily fleet briefing, cold-chain breach report, idle vehicle check, vehicle investigation and weekly performance review. Find them in your AI app's prompt or slash-command menu.

Example prompts

Use these as starting points. Registration numbers, places and trip IDs are examples.

Live fleet

  • “How many vehicles do I have, and how many are moving, idle or offline right now?”
  • “Which vehicles are idle and not on a trip in Pune?”
  • “Where is MH12AB1234 and what did it do today?”

Cold chain

  • “Which reefers are outside their temperature range right now, and which trips are they on?”
  • “Show the temperature history for MH04XY9876 over the last 24 hours with its compliance.”
  • “Which vehicles have no temperature sensor data today?”

Alerts

  • “Summarise yesterday's alerts by type and severity.”
  • “Which vehicles had the most overspeed alerts this week?”
  • “List critical alerts in the last 6 hours with vehicle and location.”

Trips

  • “Which trips are ongoing, and which are behind on checkpoints?”
  • “Which delivered trips last week had temperature abuse?”
  • “Show trip T-4521's stops, load-in and load-out times and temperature log.”

Analytics & utilisation

  • “Which 10 vehicles drove the least last week compared with their contract kilometres?”
  • “Compare fleet distance and running hours this week with last week.”
  • “Which vendors are under-utilised against their contracts this month?”

Changes (with your approval)

  • “Create a trip T-4521 for MH04XY9876 from our Bhiwandi DC to Pune, 2–8 °C, starting tomorrow 6 am.”
  • “Change the driver on trip T-4521 to Ravi Kumar.”
  • “Mark trip T-4498 as delivered.”

Getting started

Pick your AI app. Each uses the same server URL:

Server URL
https://mcp.safartrak.com/mcp
  1. In Claude, open the Directory and search for SafarTrak, or go straight to the SafarTrak listing.
  2. Click Connect to Claude.
  3. Sign in with your SafarTrak portal login, or with an API key from API Credentials, and choose whether the assistant may also create and change trips.
  4. Ask about your fleet in a chat.

Prefer to add it manually? Use Add custom connector and paste the server URL. On Claude Team and Enterprise plans an owner can add SafarTrak once for the whole organisation. Connectors added on the web appear in Claude Desktop and mobile automatically.

Find SafarTrak in the Claude Directory, connect, sign in and ask your first question.

Check the connection: ask “How many vehicles do I have, and how many are moving, idle or offline right now?”

Security & data handling

Security and data handling
AreaHow it works
No passwords sharedYour password goes only to SafarTrak. The AI app receives a SafarTrak MCP token that expires every hour and renews in the background.
Encrypted credentialsThe key behind each connection is stored encrypted with AES-256-GCM. Tokens are stored only as one-way hashes.
Scoped to your companyEvery request runs with your company's SafarTrak access, using live data. Nothing is copied or synced elsewhere.
Approval for changesTrip changes need your permission when connecting, and your AI app asks before each one.
Disconnect any timeDisconnect in the AI app, or revoke the “AI assistant (MCP)” key in API Credentials to stop access immediately.
No conversation dataSafarTrak does not receive your chats, AI memory or files, only the lookups the assistant makes.
Sessions expireSessions end after 180 days without use, and each sign-in page is valid for 15 minutes.
Traceable accessEach connection uses its own named “AI assistant (MCP)” key in API Credentials, so admins can see and revoke every one.

Read section 9A of the privacy policy for how SafarTrak MCP handles data.

Limits

SafarTrak MCP limits
AreaLimit
Rows per requestLists return 50 rows by default and up to 500 per page; ask for the next page for more. Live locations return up to 2,000 vehicles and vehicle rankings up to 200.
Response sizeAnswers larger than about 60,000 characters are cut short with a note. Narrow the question with a filter, a smaller limit or a shorter date range.
Route trailsRoute history returns runs and stops by default. GPS points for a map are only added when asked, up to 300 sampled points.
Date rangesUse today, yesterday, 7d or 30d, or exact dates. Very long ranges can hit the response-size limit; split them by week or month.
What it can changeOnly trip schedules: create, update, mark delivered and cancel. Nothing can be deleted, and vehicles, users, devices, alerts and settings are read-only.
Who can sign in with a portal loginCompany admins only, because the connection creates an API key for the company. Other users connect with an API key and password.
SessionsAccess tokens last 1 hour and renew in the background. After 180 days without use you sign in again. A sign-in page is valid for 15 minutes.
Request rateEach tool call is a request to the SafarTrak API. If many are sent very quickly they may be slowed down; wait a minute and try again.

Troubleshooting

Common problems and fixes
What you seeWhyWhat to do
“Only a company admin can connect with a portal login”Your user isn't a company admin.Ask an admin for an API key and password from API Credentials, and use the API key tab when connecting.
“This sign-in link has expired”The sign-in page was open for more than 15 minutes, or was already used.Go back to your AI app and click Connect again.
“Incorrect email or password”The portal login didn't match.Use the same email and password you use for the SafarTrak portal, or connect with an API key instead.
The AI app says SafarTrak isn't connected, or asks you to sign in againThe connection was revoked, the key was deleted, or it wasn't used for 180 days.Reconnect SafarTrak in your AI app and sign in.
Answers are cut shortThe question returned more data than fits in one answer.Add a filter (fleet group, status, vehicle), lower the number of rows or shorten the date range.
The assistant can't create or change tripsTrip changes weren't allowed when you connected.Disconnect and connect again, and keep “Also allow it to create, change and cancel trips” ticked.
A vehicle or trip isn't foundThe registration or trip id doesn't match, or it belongs to another company.Ask the assistant to search by part of the registration, or list trips by status first.

Still stuck? Email support@safartrak.com with the AI app you use, the question you asked, the time and any error message. Don't include passwords or API secrets.

FAQ

Who can connect SafarTrak MCP?

Any SafarTrak customer with API access. Company admins sign in with their portal login. Other users connect with an API key and password from the portal's API Credentials page.

Which AI apps work with it?

Claude (web, desktop and mobile, from the Claude Directory), Claude Code, ChatGPT, Cursor, VS Code with GitHub Copilot, Windsurf, Microsoft Copilot Studio and any app or agent that supports remote MCP servers over HTTP.

Does the AI app get my SafarTrak password?

No. Your password goes only to SafarTrak, which creates a dedicated “AI assistant (MCP)” key for the connection. The AI app receives a SafarTrak MCP token that expires after an hour and is renewed in the background.

Can it change data in SafarTrak?

Only if you allow it when you connect. Write tools can create, update, close and cancel trip schedules, and the AI app asks you to approve each change before it is made.

How do I disconnect it?

Disconnect SafarTrak in the AI app, or have a company admin revoke the “AI assistant (MCP)” key under API Credentials in the portal. Either stops access straight away.

Can our admin control who connects?

Yes. Portal sign-in is limited to company admins, every connection appears as its own “AI assistant (MCP)” key in API Credentials, and revoking a key cuts that connection off. On Claude Team and Enterprise, only owners can add connectors for the organisation.

Can it delete anything?

No. The only changes it can make are to trip schedules: create, update, mark delivered and cancel. Everything else is read-only.

Does it keep a copy of our fleet data?

No. Each question is answered from live SafarTrak data at the time you ask. The MCP server stores only the encrypted connection key and hashed tokens.

Is my conversation stored by SafarTrak?

No. SafarTrak only receives the lookups the assistant makes, such as a vehicle or date range, and returns that data. See section 9A of the privacy policy.

Resources

Questions about the API or MCP? Email support@safartrak.com (24/7) or contact the team.