Cariot MCP Server

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

Quick Start

Prerequisites

• Node.js v22+ (ES modules support)

• Cariot API credentials (one of the following):

  • API Access Key and Secret

  • ID Token (from Cariot authentication)

Configuration

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

Option 1: API Key Authentication (Recommended)

{
  "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"
      }
    }
  }
}

Option 2: ID Token Authentication

{
  "mcpServers": {
    "cariot": {
      "command": "npx",
      "args": ["@cariot-labs/cariot-mcp-server"],
      "env": {
        "ID_TOKEN": "your-id-token"
      }
    }
  }
}

Environment Variables

Authentication (one of the following is required):

Note: If both API key credentials and ID token are provided, API key authentication takes priority.

Optional:

No Installation Required

npx automatically downloads and runs the server.

Related MCP server: MCP Energy 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.

Utility Tools

• generate_chart_config: Generate Chart.js configuration data based on input data. Supports bar, line, pie, doughnut, radar, and polarArea chart types. This tool can be used to visualize data obtained from other tools.

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

Local Configuration

Using API Key:

{
  "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