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?”
SafarTrak MCP
Your fleet data,
in Claude, ChatGPT and your own agents.
SafarTrak MCP connects your AI assistant to live SafarTrak data. Ask about vehicles, cold-chain temperatures, alerts, trips and utilisation in plain language, and create or update trips with your approval.
Connect
Add SafarTrak to Claude in under a minute.
- 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 in the Directory and paste the server URL below.
https://mcp.safartrak.com/mcpOn Claude Team and Enterprise plans an owner can add SafarTrak once for the whole organisation. Portal sign-in is for company admins; other users connect with an API key and password.
ChatGPT
Use SafarTrak in ChatGPT.
- In ChatGPT, open Plugins, click Add and choose Add custom MCP server.
- Name it SafarTrak, paste the server URL above and keep OAuth as the authentication.
- Create it, click Connect SafarTrak and sign in with your SafarTrak 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.
What to ask
Ask across vehicles, temperatures, alerts and trips in one question.
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.”
New to it? Start with “How many vehicles do I have, and how many are moving, idle or offline right now?” to check the connection.
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.
Tools
25 tools: 21 that read, 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. |
Other apps & agents
Same server, every MCP-capable tool.
ChatGPT: add it under Plugins → Add → Add custom MCP server, as shown above.
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" }
}
}Claude Desktop and mobile: connectors added in Claude on the web appear in the desktop and mobile apps automatically.
{
"servers": {
"safartrak": { "type": "http", "url": "https://mcp.safartrak.com/mcp" }
}
}{
"mcpServers": {
"safartrak": { "serverUrl": "https://mcp.safartrak.com/mcp" }
}
}Microsoft Copilot Studio: add a Model Context Protocol tool to your agent with the server URL above and OAuth 2.0 sign-in. Any other app or agent that supports remote MCP servers over HTTP connects the same way.
POST https://mcp.safartrak.com/mcp
X-API-Key: <your API key ID>
X-API-Password: <your API secret>Building directly on the REST API instead? See the Developers & API reference.
Access & security
Your AI app sees what your account can see, and nothing more.
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. Support: support@safartrak.com.
Limits
Limits and known limitations.
What SafarTrak MCP returns in one request, what it can change and how sessions work.
| 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
If something doesn't work.
| 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.
Questions
Questions about
SafarTrak MCP.
Ask us about API access, connecting your team or using SafarTrak in your own AI agents.
Talk to our teamWho 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.
See SafarTrak at work
Show us the fleet problemyou want to solve.
Tell us which AI apps your team uses and who should connect. We will enable API access for your account and help you make the first connection.
Talk to the SafarTrak team