Bouncie MCP Server

An MCP (Model Context Protocol) server that exposes the Bouncie vehicle tracking API. Connect your Bouncie OBD2 device data to any MCP-compatible AI assistant.

Features

• Vehicle info — make, model, year, VIN, engine, nickname
• Live vehicle stats — GPS location, speed, fuel level, odometer, engine running status
• Vehicle health — battery status, check engine light (MIL), diagnostic trouble codes (DTCs)
• Trip history — distance, duration, speeds, fuel consumed, hard braking/acceleration, GPS traces
• User profile — authenticated user information

Prerequisites

1. A Bouncie account with at least one connected device
2. A Bouncie developer app — register at bouncie.dev
3. Node.js 18+

Setup

1. Install

npm install
npm run build

2. Get Bouncie API credentials

1. Go to bouncie.dev and create an app
2. Note your Client ID and Client Secret
3. Set a Redirect URI (e.g. https://example.com/callback)
4. Under "Users & Devices", authorize your Bouncie account
5. Copy the Authorization Code from the device's expanded view

3. Configure environment

Set these environment variables:

4. Add to your MCP client

Claude Desktop / Claude Code

Add to your MCP settings (claude_desktop_config.json or .claude/settings.json):

{
  "mcpServers": {
    "bouncie": {
      "command": "node",
      "args": ["/path/to/bouncie-mcp/dist/index.js"],
      "env": {
        "BOUNCIE_CLIENT_ID": "your-client-id",
        "BOUNCIE_CLIENT_SECRET": "your-client-secret",
        "BOUNCIE_REDIRECT_URI": "https://example.com/callback",
        "BOUNCIE_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Tools

get_vehicles

List all vehicles on the account.

Returns: Array of vehicles with model info, VIN, IMEI, nickname, and live stats (location, speed, fuel, odometer, engine status, battery, MIL/DTCs).

get_vehicle

Get a single vehicle by VIN or IMEI.

At least one identifier is required.

get_trips

Get trip history for a vehicle.

Note: The date window (starts_after to ends_before) must be no longer than 1 week. Defaults to the last 7 days if not specified.

Returns: Array of trips with distance, duration, average/max speed, fuel consumed, hard braking/acceleration counts, odometer readings, and GPS trace.

get_user

Get the authenticated user's profile.

No parameters.

Development

npm run dev        # Run with tsx (hot reload)
npm run build      # Compile TypeScript
npm test           # Run tests
npm run test:watch # Watch mode
npm run lint       # Type check

API Reference

This server wraps the Bouncie REST API v1:

• Base URL: https://api.bouncie.dev/v1
• Auth: https://auth.bouncie.com/oauth/token
• Endpoints: /vehicles, /trips, /user

Webhook Event Types

Bouncie also supports webhooks (not exposed via this MCP server, but documented here for reference):

License

MIT