flespi_get_devicesLABSCO SUMMARY
Generated coverage, with the cost that implies.
Generating from the API means nothing is missing — including the create, update and delete operations on every resource, which is worth a deliberate decision before connecting a model to a live fleet. It also means a large surface: start from the tool-listing utility rather than trying to hold every name in mind. The selector syntax is the part that repays reading, since it is the difference between pulling one truck's messages and pulling the whole fleet's.
What it is
An MCP server covering the Flespi telematics platform, with the tool surface generated from the API rather than hand-picked. Every Flespi resource — the devices that report position, the channels that receive protocol traffic, the streams that forward it, the calculators that turn it into reports — is addressable, with schemas validated on the way in.
What you get
- The README counts 157 tools — 155 generated API operations plus 2 utilities — but names only eight; the rest follow the method-and-resource pattern
- A predictable naming scheme, so a tool name follows from the HTTP method and the resource —
flespi_get_deviceslists devices,flespi_post_devicescreates them,flespi_get_devices_messagespulls their telemetry,flespi_put_channelsupdates a channel,flespi_delete_streamsremoves a stream - The full resource set: tracking devices, protocol input channels, outbound data streams, the calculators that produce analytics and reports, assets as virtual multi-device entities, plugins, geofences for geospatial analysis, groups for bulk management, and modems for sending SMS and commands
- Flespi selectors as first-class arguments, so a query targets what you mean — all devices, specific ids, an IMEI, a name pattern with wildcards, only the connected ones, or everything in a group
- Field selection on reads, so a message query can ask for just timestamp, position and speed instead of the whole record
- A discovery tool that lists every available tool with its category, and one that returns the platform's protocols and device types —
flespi_list_tools,flespi_get_protocols - Documentation carried in the schemas: 77 global parameters and 38 specialized selectors with usage examples
Requirements
A Flespi account and a token created in the Tokens section of your dashboard, scoped to the permissions you want. The token is not an environment variable — every tool takes a token argument, so it is passed per call. Node.js; clone the repository, npm install, and point your client at server.js with node, setting the working directory to the project. The package is flespi-mcp-server (1.0.0 in package.json). An internet connection is required, and Flespi's own API limits apply.
Setup effort
Build from source — git clone https://github.com/gperezt222/flespi-mcp-server.git
USE CASES
Answering where a vehicle is
Select the device by IMEI or name pattern and pull its recent messages with just the position and timestamp fields.
Onboarding a new tracker
Check which protocols and device types the platform supports, create the device, and attach it to the right channel.
Extracting history for analysis
Query messages across a selected group of devices with the fields you need, rather than exporting everything and filtering later.
Finding the right call in a large surface
List the available tools by category first, so an unfamiliar operation is found rather than guessed.
8 tools
Listed in project docs. Your client may show a different list.
flespi_post_devicesflespi_get_devices_messagesflespi_put_channelsflespi_delete_streamsflespi_post_channelsflespi_get_protocolsflespi_list_toolsBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
node on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
git clone https://github.com/gperezt222/flespi-mcp-server.git
cd flespi-mcp-server
npm installMCP Clients
Claude Desktop
{
"mcpServers": {
"flespi": {
"command": "node",
"args": [
"<YOUR_PATH_TO_FLESPI_MCP_SERVER>/server.js"
],
"cwd": "<YOUR_PATH_TO_FLESPI_MCP_SERVER>"
}
}
}