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
| Type | Tool | What it does |
|---|---|---|
| Read | Fleet summary | Vehicle counts by live status: moving, idle, offline and no GPS. |
| Read | List vehicles | Vehicles with status, speed, driver, vendor, client and city. Filter by status, fleet group, category, type or registration number. |
| Read | Vehicle details | Live details for one vehicle. |
| Read | Live locations | Latest position of every vehicle. |
| Read | Route history | Distance, running and stopped time, and every run and stop for a day or date range. |
Cold chain & alerts
| Type | Tool | What it does |
|---|---|---|
| Read | Temperature status | Current reefer temperature against each vehicle's range, with breaches and how long they lasted. |
| Read | Temperature history | Readings over time for one vehicle, with a compliance summary. |
| Read | Alerts | Alert summary, alert types and alert events by vehicle, type, severity and time. |
Trips
| Type | Tool | What it does |
|---|---|---|
| Read | Trip summary & list | Trips by status, with checkpoints completed and temperature-abuse flags. |
| Read | Trip details | One trip's stops, load-in and load-out events and temperature log. |
| Write | Create trip | Create a trip schedule for a vehicle with its route, timings and temperature range. |
| Write | Update trip | Change a trip's vehicle, driver, times, points or temperature range. |
| Write | Mark delivered | Close a trip as delivered. |
| Write | Cancel trip | Cancel a trip schedule. |
Analytics & utilisation
| Type | Tool | What it does |
|---|---|---|
| Read | Fleet analytics | Distance, running and idle hours and fleet score for a period. |
| Read | Distance trend | Daily distance for the fleet, ready to chart. |
| Read | Vehicle ranking | Highest or lowest vehicles by distance, with change against the previous period. |
| Read | Utilisation | Kilometre and hour utilisation against contract by vehicle and vendor, with optimisation flags. |
| Read | Lookups | Fleet 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:
https://mcp.safartrak.com/mcp- In Claude, open the Directory and search for SafarTrak, or go straight to the SafarTrak listing.
- Click Connect to Claude.
- 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.
- 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.
- In ChatGPT, open Plugins, click Add and choose Add custom MCP server.
- Name it SafarTrak, paste the server URL and keep OAuth as the authentication.
- Create it, click Connect SafarTrak and sign in with your portal login or an API key.
- In a chat, type @SafarTrak and ask about your fleet.
Custom MCP servers depend on your ChatGPT plan and workspace settings. On business workspaces an admin may need to allow them.
claude mcp add --transport http safartrak https://mcp.safartrak.com/mcp
# then run /mcp in Claude Code and choose Authenticate{
"mcpServers": {
"safartrak": { "url": "https://mcp.safartrak.com/mcp" }
}
}{
"servers": {
"safartrak": { "type": "http", "url": "https://mcp.safartrak.com/mcp" }
}
}{
"mcpServers": {
"safartrak": { "serverUrl": "https://mcp.safartrak.com/mcp" }
}
}Add a Model Context Protocol tool to your agent with the server URL and OAuth 2.0 sign-in. Any other app or agent that supports remote MCP servers over HTTP connects the same way.
Any MCP client can connect with API key headers instead of OAuth.
POST https://mcp.safartrak.com/mcp
X-API-Key: <your API key ID>
X-API-Password: <your API secret>Check the connection: ask “How many vehicles do I have, and how many are moving, idle or offline right now?”
Security & data handling
| Area | How it works |
|---|---|
| No passwords shared | Your password goes only to SafarTrak. The AI app receives a SafarTrak MCP token that expires every hour and renews in the background. |
| Encrypted credentials | The key behind each connection is stored encrypted with AES-256-GCM. Tokens are stored only as one-way hashes. |
| Scoped to your company | Every request runs with your company's SafarTrak access, using live data. Nothing is copied or synced elsewhere. |
| Approval for changes | Trip changes need your permission when connecting, and your AI app asks before each one. |
| Disconnect any time | Disconnect in the AI app, or revoke the “AI assistant (MCP)” key in API Credentials to stop access immediately. |
| No conversation data | SafarTrak does not receive your chats, AI memory or files, only the lookups the assistant makes. |
| Sessions expire | Sessions end after 180 days without use, and each sign-in page is valid for 15 minutes. |
| Traceable access | Each 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
| Area | Limit |
|---|---|
| Rows per request | Lists 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 size | Answers 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 trails | Route history returns runs and stops by default. GPS points for a map are only added when asked, up to 300 sampled points. |
| Date ranges | Use 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 change | Only 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 login | Company admins only, because the connection creates an API key for the company. Other users connect with an API key and password. |
| Sessions | Access 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 rate | Each 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
| What you see | Why | What 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 again | The 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 short | The 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 trips | Trip 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 found | The 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.