cariot-mcp-server

CariotInc/cariot-mcp-server

3.3

If you are the rightful owner of cariot-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Cariot MCP Server is a Model Context Protocol server that integrates with Cariot APIs to provide seamless data management and retrieval for connected vehicles and devices.

Tools
5
Resources
0
Prompts
0

Cariot MCP Server

A Model Context Protocol (MCP) server with cariot APIs.

Quick Start

Prerequisites

  • Node.js v22+ (ES modules support)
  • Cariot API credentials (API Secret Key, API Access Secret)

Configuration

Add the following configuration to your MCP-enabled client (e.g., Claude Desktop) settings.

Authentication Setup via Environment Variables
{
  "mcpServers": {
    "cariot": {
      "command": "npx",
      "args": ["@cariot-labs/cariot-mcp-server"],
      "env": {
        "API_ACCESS_KEY": "your-api-access-key",
        "API_ACCESS_SECRET": "your-api-access-secret"
      }
    }
  }
}

Required Environment Variables:

  • API_ACCESS_KEY: Cariot API access key
  • API_ACCESS_SECRET: Cariot API access secret

Optional Environment Variables:

  • CARIOT_LOG_LEVEL: Logging level (debug, info, warn, error). Default: info

No Installation Required

npx automatically downloads and runs the server.

Available Tools

Cariot Tools

  • analyze_alcohol_checks: Analyze alcohol check results from daily reports to monitor compliance and identify violations.
  • get_daily_report: Get a specific daily report by daily report number.
  • get_daily_reports: List daily reports.
  • get_drivers: List drivers.
  • get_vehicles: List vehicles.
  • get_realtime: Get realtime snapshots for devices.

Authentication

This MCP server uses the following authentication flow:

  1. Initial Authentication: Login using API_ACCESS_KEY and API_ACCESS_SECRET
  2. Token Acquisition: Obtain api_token upon successful authentication
  3. Auto Refresh: Automatic re-authentication when token expires
  4. Retry Logic: Automatic retry on 401 errors

Development

Local Development

# Clone repository
git clone https://github.com/CariotInc/cariot-mcp-server.git
cd cariot-mcp-server
npm install

# Test
npm test

# Build
npm run build

Configuration

{
  "mcpServers": {
    "cariot": {
      "command": "node",
      "args": ["/path/to/cariot-mcp-server/dist/index.js"],
      "env": {
        "API_ACCESS_KEY": "your-access-key",
        "API_ACCESS_SECRET": "your-access-secret",
        "CARIOT_LOG_LEVEL": "debug"
      }
    }
  }
}

License

MIT