cariot-mcp-server

CariotInc/cariot-mcp-server

3.2

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 dayong@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 (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):

VariableDescription
API_ACCESS_KEYCariot API access key (used with API_ACCESS_SECRET)
API_ACCESS_SECRETCariot API access secret (used with API_ACCESS_KEY)
ID_TOKENCariot ID token for authentication

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

Optional:

VariableDescriptionDefault
CARIOT_LOG_LEVELLogging level (debug, info, warn, error)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.

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