# AirTrail MCP Server

An MCP (Model Context Protocol) server for managing your [AirTrail](https://github.com/johanohly/AirTrail) flight tracking instance through AI assistants.

## Overview

This server enables LLMs to interact with your self-hosted AirTrail application, providing natural language access to your flight data. Manage your travel history, search flights, and analyze statistics through conversational interfaces.

**Example:**
> When was my last trip to france?

> Get my flights tickets from the download foolder and add the trips information to airtrail 

## Prerequisites

- A running [AirTrail](https://github.com/johanohly/AirTrail) instance
- MCP-compatible client (Claude Code/Desktop, [OpenCode](https://opencode.ai/))
- AirTrail API credentials

## Usage 
1. Clone this project
2. Create a .env file
```txt
AIRTRAIL_API_KEY=
AIRTRAIL_BASE_URL=http://localhost:5173/api
AIRTRAIL_USER_ID=
```
3. Edit your client config file 
```json
{
  "mcpServers": {
    "airtrail": {
      "command": "uv",
      "args": ["run" , "/the-project-path/AirTrail_MCP_server/src/server.py"],
    }
  }
}
```