# FAA Advisory Circular MCP

An MCP (Model Context Protocol) server that lets you search, retrieve, and track FAA Advisory Circulars (ACs) relevant to airport operations — for both **Part 139 certificated commercial service airports** and **general aviation airports**.

## What It Does

- **Search ACs** by keyword, AC number, or topic
- **Filter by airport type** — Part 139 or GA
- **Get full AC details** — what it covers, key provisions, what it amends/supersedes, regulatory references
- **Direct FAA links** to every AC's page and PDF download
- **Bookmark and track ACs** with your own notes per airport
- **Export summaries** as printable markdown (optionally saves to a folder you specify)
- **Persistent memory** — airport profile and bookmarks are stored locally in `data/`

---

## Tools

| Tool | Description |
|------|-------------|
| `set_airport_profile` | Configure your airport name, ICAO code, type, and optional save folder |
| `get_airport_profile` | View current airport profile |
| `search_circulars` | Search by keyword, AC number, or topic |
| `list_circulars_by_subject` | Browse ACs by subject area (ARFF, markings, construction, etc.) |
| `get_circular_details` | Full detail view for a specific AC |
| `bookmark_circular` | Save an AC to your tracking list with optional notes |
| `list_bookmarks` | View all tracked ACs |
| `remove_bookmark` | Remove from tracking |
| `export_circular_summary` | Generate a printable markdown summary for one AC |
| `export_bookmarks` | Generate a full printable report of all tracked ACs |

---

## Subject Areas Covered

| Code | Area |
|------|------|
| `safety` | Safety & Operations (NOTAMs, Emergency Plans, SMS) |
| `arff` | Aircraft Rescue & Fire Fighting |
| `equipment` | Airport Equipment (ARFF Vehicles, FOD Detection) |
| `fueling` | Fuel Storage, Handling & Dispensing |
| `design` | Airport Design |
| `pavement` | Pavement Design & Evaluation |
| `markings` | Runway & Taxiway Markings |
| `lighting` | Airfield Lighting |
| `terminals` | Terminal Facilities |
| `construction` | Construction Safety & Standards |
| `maintenance` | Pavement Maintenance |
| `heliports` | Heliport Design |
| `wildlife` | Wildlife Hazard Management |
| `winter_ops` | Winter Operations |
| `sms` | Safety Management Systems |

---

## Installation

```bash
npm install
npm run build
```

---

## Configuration in Claude Code / CoWork

Add to your Claude Code MCP config (`claude_desktop_config.json` or via settings):

```json
{
  "mcpServers": {
    "faa-advisory-circular": {
      "command": "node",
      "args": ["C:/Users/paris/Desktop/faa-advisory-circular-mcp/dist/index.js"]
    }
  }
}
```

---

## Memory & File Storage

- **Airport profile** and **bookmarks** are stored in `data/profile.json` and `data/bookmarks.json` — they persist between sessions automatically.
- **In CoWork or any session with a save folder configured:** use `set_airport_profile` with a `save_folder` path, and `export_circular_summary` / `export_bookmarks` will also write `.md` files to that folder — ready to print or open in Word.
- **In chat without a folder:** exports return as text in the conversation. Everything still lives in the `data/` directory for next time.

---

## FAA Resources

- **Advisory Circulars Search:** https://www.faa.gov/regulations_policies/advisory_circulars/
- **Regulatory Guidance Library:** https://rgl.faa.gov/Regulatory_and_Guidance_Library/rgAdvisoryCircular.nsf/
- **Part 139 Airport Certification:** https://www.faa.gov/airports/airport_safety/part139_cert/