# MAXICAR MCP Server

A Model Context Protocol (MCP) server for **MAXICAR** — Montenegro's travel marketplace. Search transfers, rent cars, and book rides with real-time pricing from multiple licensed providers.

## What can it do?

| Tool | Description |
|------|-------------|
| `search_transfers` | Find airport & private transfer options with live pricing |
| `search_rental_cars` | Browse available rental cars by type, brand, price, city |
| `book_transfer` | Book a transfer (creates a real reservation) |
| `book_rental_car` | Book a rental car (creates a real reservation) |
| `get_maxicar_info` | Company info, policies, FAQ, driving tips |
| `get_montenegro_destinations` | Destination guide with routes and highlights |

## Example prompts

- "I need a transfer from Tivat Airport to Budva for 3 people"
- "Show me SUVs available for rent in Montenegro under 60 EUR/day"
- "Book a transfer from Podgorica Airport to Kotor on July 15 at 14:00"
- "What are the driving rules in Montenegro?"
- "Tell me about destinations near Kotor"

## Installation

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "maxicar": {
      "command": "npx",
      "args": ["@maxicar/mcp-travel"],
      "env": {
        "MAXICAR_API_URL": "https://maxicar.me",
        "MAXICAR_BOT_SECRET": "your-secret"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add maxicar -- npx @maxicar/mcp-travel
```

### Manual / Development

```bash
git clone https://github.com/ermanozkaya/maxicar-mcp.git
cd maxicar-mcp
npm install
npm run build
```

Set environment variables:
```bash
export MAXICAR_API_URL=https://maxicar.me
export MAXICAR_BOT_SECRET=your-secret
```

Run:
```bash
npm start
```

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `MAXICAR_API_URL` | No | `https://maxicar.me` | API base URL |
| `MAXICAR_BOT_SECRET` | Yes | — | Bot API authentication secret |

## Coverage

- **Airports:** Tivat (TIV), Podgorica (TGD)
- **Cities:** Budva, Kotor, Herceg Novi, Tivat, Podgorica, Bar, Ulcinj, Cetinje, Sveti Stefan, Zabljak
- **Cross-border:** Dubrovnik (Croatia), Sarajevo (Bosnia), Tirana (Albania)
- **Services:** Airport transfers, point-to-point transfers, car rental
- **Currency:** EUR
- **Languages:** English, Montenegrin, Turkish, Serbian, Bosnian, Russian, German

## About MAXICAR

MAXICAR is a travel marketplace connecting travelers with licensed transfer and car rental providers in Montenegro. Compare prices from multiple companies, book online, and enjoy fixed-price rides with meet & greet service.

- Website: [maxicar.me](https://maxicar.me)
- Available 24/7
- Licensed and insured providers

## License

MIT