@draiv/mcp-server

MCP (Model Context Protocol) server for the DRAIV car rental platform. Search for available cars, check availability, and manage your bookings through AI assistants like Claude.

Installation

npm install -g @draiv/mcp-server

Or use directly with npx:

npx @draiv/mcp-server

Quick Start

Claude Code Setup

Add to .claude/settings.local.json:

{
  "mcpServers": {
    "draiv": {
      "command": "npx",
      "args": ["@draiv/mcp-server"],
      "env": {
        "CONVEX_URL": "https://careful-jaguar-818.convex.cloud"
      }
    }
  }
}

Claude Desktop Setup

Add to Claude Desktop's config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "draiv": {
      "command": "npx",
      "args": ["@draiv/mcp-server"],
      "env": {
        "CONVEX_URL": "https://careful-jaguar-818.convex.cloud",
        "DRAIV_API_KEY": "draiv_sk_live_your_api_key_here"
      }
    }
  }
}

Available Tools

Public Tools (No Auth Required)

| Tool | Description | |------|-------------| | search_available_cars | Search for cars by city, type, seats, price, dates, and more | | search_with_alternatives | Smart search that suggests alternatives when no exact matches found | | get_next_available_time | Find when specific car types become available |

Search Filters

The search_available_cars tool supports these filters:

| Filter | Type | Description | |--------|------|-------------| | city | string | City name (e.g., "Zürich", "Basel") | | make | string | Car brand (e.g., "BMW", "Tesla") | | model | string | Car model | | bodyType | string | SUV, Sedan, Hatchback, etc. | | seats | number | Minimum seats required | | transmission | string | "automatic" or "manual" | | fuelType | string | "electric", "petrol", "diesel" | | maxDailyRate | number | Maximum price in CHF per day | | startTime | number | Rental start (Unix timestamp ms) | | endTime | number | Rental end (Unix timestamp ms) | | is4x4 | boolean | Filter for 4x4/AWD vehicles | | minRange | number | Minimum EV range in km | | features | string[] | Required features (e.g., ["pet_friendly"]) | | limit | number | Max results (default: 5) |

User Tools (Auth Required)

These tools require a valid API key with user permissions.

| Tool | Description | |------|-------------| | get_user_bookings | Get your booking history | | get_active_booking | Get your current or upcoming booking with pickup details | | get_car_by_license_plate | Look up car details by license plate |

Authentication

Access Levels

| Role | Description | |------|-------------| | public | Search cars (no auth required) | | user | Access your own bookings |

API Key Format

draiv_sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Get your API key from the DRAIV Developer Portal.

Example Usage

Once configured, use natural language in Claude:

"Search for electric cars in Zürich under 100 CHF per day"

"Are there any SUVs available in Basel this weekend?"

"When is the next Tesla available in Zürich?"

"Show me my current booking"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CONVEX_URL | Yes | https://careful-jaguar-818.convex.cloud | | DRAIV_API_KEY | No* | API key for authenticated access |

*Without an API key, only public search tools are available.

Rate Limiting

| Limit | Window | |-------|--------| | 60 requests | 60 seconds |

When rate limited, wait for the retryAfter seconds indicated in the response.

Changelog

v0.4.0 (December 2025)

• Added search_with_alternatives - smart search with fallback suggestions
• Added get_next_available_time - availability queries
• Enhanced search filters: is4x4, minRange, features
• Improved response formatting

v0.3.0

• Added rate limiting (60 req/min)
• Added usage tracking

v0.2.0

• Added API key authentication
• Role-based access control

v0.1.0

• Initial release with car search and booking tools

Support

• Developer Portal: draiv.ch/developers
• API Keys: draiv.ch/developers/keys
• Contact: [email protected]

License

MIT