# Aviationstack

> Live flight status — gate, terminal, boarding, delay, baggage belt. Same-day only.

- **Type:** Skill
- **Install:** `agentstack add skill-shlomsh-hermes-travel-skills-aviationstack`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shlomsh](https://agentstack.voostack.com/s/shlomsh)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shlomsh](https://github.com/shlomsh)
- **Source:** https://github.com/shlomsh/hermes-travel-skills/tree/main/skills/aviationstack

## Install

```sh
agentstack add skill-shlomsh-hermes-travel-skills-aviationstack
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Aviationstack — Live Flight Tracker

Live gate, terminal, delay, and baggage-belt data for any flight, by IATA flight number or airport.

## When to use

Reach for this whenever the user asks about the live status of a flight — gate, terminal,
boarding, delay, landing, or which belt the baggage is on. Resolve the IATA flight number
from context (itinerary, a forwarded confirmation, a screenshot) when you can, so you don't
have to ask the user for it.

| User asks | You do |
|---|---|
| gate / terminal / boarding | `flight ` → `departure.terminal`, `departure.gate`, `departure.delay` |
| landed / touched down | `flight ` → status LANDED + `arrival.actual` |
| luggage / baggage belt | `flight ` → `arrival.baggage` (belt number) |
| delay / on time | `flight ` → `departure.delay` (0 = on time ✓) |

## Example questions

| You ask | You run |
|---|---|
| "Which baggage belt is the luggage from flight LY574 coming out on?" | `flight LY574` → `arrival.baggage` |
| "Is flight IZ212 departing on time, or is it delayed?" | `flight IZ212` → `departure.delay` (0 = on time ✓) |
| "Where do I pick up my bags — which carousel?" | `flight ` → `arrival.baggage` |
| "Has flight AA100 landed yet?" | `flight AA100` → status + `arrival.actual` |

## Usage

```bash
python live_flight_tracker.py flight LY8           # today (the only reliable mode on free tier)
python live_flight_tracker.py airport TLV dep
python live_flight_tracker.py airport MIA arr active
```

The `flight` command takes an optional `[YYYY-MM-DD]`, but a date other than today needs a
**paid** aviationstack plan — on the free key it returns "No data found". Track each flight
**on its travel day**, not in advance.

## Status icons
`🕐 SCHEDULED` · `✈️  ACTIVE` · `🛬 LANDED` · `❌ CANCELLED` · `↩️  DIVERTED` · `⚠️  INCIDENT`

## Notes
- Free tier: same-day real-time only, HTTP, 100 req/month — one call per question, never poll.
- Gate and baggage belt can change — always fetch live.
- Requires `AVIATIONSTACK_API_KEY` in the environment. Note: the free tier is HTTP-only, so the
  key travels unencrypted in the request URL.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shlomsh](https://github.com/shlomsh)
- **Source:** [shlomsh/hermes-travel-skills](https://github.com/shlomsh/hermes-travel-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shlomsh-hermes-travel-skills-aviationstack
- Seller: https://agentstack.voostack.com/s/shlomsh
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.