# Gaduin

> Gaduin is a free MCP server for maps and travel. Read-only flight, airport, rail and shipping-chokepoint status plus transport markets. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://gaduin.com/agents
- **MCP Registry name:** com.gaduin/gaduin
- **Categories:** maps and travel, freight and logistics
- **Listing updated:** 2026-11-14

## About

Gaduin pairs live travel-disruption data with prediction markets on transport outcomes such as flight delays, train punctuality, ship arrivals and chokepoint ship counts. Through MCP an assistant can read both, and every tool is read-only: trades and withdrawals happen only on the website, by a person.

The flight tools cover status by flight number, a 30-day history of on-time, late and cancelled counts, and departures search by airport, destination or airline. Airline and airport tools report on-time shares, delay percentiles and a disruption score, and a station board lists upcoming rail departures with platforms and delays. Maritime tools show chokepoints such as Suez against their normal daily ship count.

Most tools need no key. Positions and balance need an API key from your Gaduin account, and those calls only return that account's data. Unkeyed access is limited to 30 requests a minute per address, and a key to one request per second.

## Features

- **Flight lookups:** Status by flight number, 30-day history and departures search.
- **Airport and airline stats:** Disruption scores, delayed and cancelled shares and delay percentiles.
- **Rail station boards:** Next departures and arrivals with delays and platforms.
- **Shipping chokepoints:** Daily ship counts compared with normal for each chokepoint.
- **Prediction markets:** List markets, read rules and prices, and fetch price history.
- **Key only for account data:** Only positions and balance need an API key.

## Good for

- Check whether a flight has been late recently
- See which airports are most disrupted today
- Compare an airline's on-time record
- Follow ship traffic through Suez against normal
- Read current odds on a delay market

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gaduin https://gaduin.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gaduin.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gaduin": {
      "url": "https://gaduin.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gaduin": {
      "type": "http",
      "url": "https://gaduin.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gaduin": {
      "serverUrl": "https://gaduin.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gaduin": {
      "type": "http",
      "url": "https://gaduin.com/mcp"
    }
  }
}
```

## Tools

- `list_markets`: List prediction markets on real-world transport outcomes (flight delays, train punctuality, ship arrivals, weekly ship counts through maritime chokepoints, airport flight counts), filtered by status (OPEN by default; CLOSED, SETTLED or CANCELLED for past ones), category and a free-text query matched against the route, flight number, airline, airport codes and vehicle. Returns total (every market t
- `get_market`: One market by id or slug: its question, the rule it settles on, route, outcomes with current prices, volume, close time, status and, once settled, the outcome it settled on, with a link to its page.
- `get_market_price_history`: How a market's prices moved: up to 180 timestamped points, oldest first, each with one price per outcome (in outcome order, 0 to 1). Shows how the market's view of an outcome changed over its life, including for closed and settled markets. The history reads a market's most recent 2,000 trades: when it has more, truncated is true and the series starts at starts_at, not at the market's open.
- `get_flight_status`: Current status of a flight by number (e.g. AA1 or AAL1). Returns the canonical flight number and the leg its gaduin.com flight page answers with (today's leg in its own time zone, else the active leg nearest now, else the latest one; with date, that service date's leg), with its role (current: left and not landed, inside its arrival horizon; next: not yet left; latest: landed, cancelled, no arriva
- `get_flight_history`: How often a flight has been late over the last 30 days, or the last days days (up to 400, the record's reach). Returns n (arrivals graded against a published arrival schedule) with its on-time and late counts, ungraded_arrivals (landings with no published schedule to grade), cancelled and diverted counts, operations (n + cancelled + diverted, the base for shares), unconfirmed legs left out, the wi
- `search_flights`: Today's departures on record from an airport (airport-local day; date picks another local day), optionally only those to one destination (an airport code, or a city matched as whole words) or flown by one airline: finds flights without knowing their number. coverage is on_record: the counts cover the flights on record for this airport today, not its full schedule. Counts over the matching flights:
- `get_airline_stats`: An airline's last 30 days of the flights on record that it operates itself (coverage on_record: the flights on record, not its full schedule): arrivals graded against a published schedule, on-time and late counts, the on-time share, median and 90th-percentile arrival delay (all three only from 20 graded arrivals), landings left ungraded, cancellations, diversions, routes flown, up to five most and
- `list_flight_disruptions`: Flights on record leaving, on its local today, an airport whose own departures board GADUIN reads, that are cancelled or late now (coverage on_record: not every flight). Late means departed, or published to depart, more than late_threshold_minutes plus the airport's taxi allowance after the schedule its board shows, and not yet landed; an airport with no measured allowance lists only cancellations
- `get_flight_position`: Where a flight is now: finds the aircraft broadcasting the flight number's callsign (the operating airline's ICAO code followed by the number) and returns its latest reported position: latitude, longitude, barometric altitude, ground speed, course, whether it reported being on the ground, its callsign, its ICAO 24-bit address, when it was reported and its age in seconds. The aircraft is named only
- `get_flight_track`: For each operation of a flight number on one service date, every position recorded for the aircraft flying it from its departure until its arrival was recorded, oldest first, each with latitude, longitude, barometric altitude, course and whether it is contested (the aircraft was flying for another operation at the same time as far as GADUIN can tell). GADUIN follows the aircraft of some operations
- `get_aircraft_position`: The latest position on record for the aircraft with this ICAO 24-bit address, however old: latitude, longitude, barometric altitude, ground speed, course, on-ground state and callsign (both null unless reported in the last 15 minutes), when it was reported and its age in seconds. live is true only when it is at most 180 seconds old, two of GADUIN's 90-second reading intervals; an older position is
- `get_aircraft_track`: Every position recorded for an aircraft from from to to, both inclusive, oldest first; nothing is cut. The window may span at most 6 hours and must start within the last 90 days; a longer or older window is refused, so read a longer stretch window by window. GADUIN reads every aircraft's position once every 90 seconds and keeps a point only when the reported position time moved, so points are typi
- `list_aircraft_in_area`: Every aircraft whose latest reported position lies inside a box (edges included) and is at most 180 seconds old (live), each as get_aircraft_position reports it, nearest the box's centre first (ties by icao24, so a limit always keeps the same ones). An aircraft whose latest position is older, or lies outside the box, is not listed. total counts them all; truncated is true when the limit cut the fa
- `get_observed_flights`: The flights of one UTC date read off positions reported by aircraft transponders under the flight number's broadcast callsign: the airline's ICAO designator and the number (matched_by callsign, with the callsigns tried). An airline whose callsigns do not follow its flight numbers returns nothing, and neither does a codeshare number. Each flight is one aircraft's observed takeoff and landing with t
- `get_airport_status`: How an airport is running today (airport-local day), with a link to its page on gaduin.com. departures: today's flights on record scheduled in the local day, each counted once, with coverage on_record (the counts cover the flights on record for this airport today, not its full schedule); of those due (scheduled at or before now) each is exactly one of on_time, delayed, cancelled, not_reported (no 
- `list_disrupted_airports`: Today's airports rated disrupted or severe that have a page on gaduin.com, in GADUIN's ranking: those rated on departures first by disrupted share of the departures on record, then those rated on arrival cancellations; each with the same reading as get_airport_status. total_disrupted counts every such airport; returned is how many of them, from the worst, this answer lists (at most limit). Departu
- `get_airport_departures`: One page of an airport's departures on record for one airport-local day, departed and cancelled flights included (coverage on_record: the flights GADUIN has a record of, not the airport's full schedule). Each physical flight appears once with its codeshares, ordered by scheduled departure (unknown schedules last), with destination, scheduled, estimated and recorded departure in UTC, status, delay 
- `get_airport_arrivals`: One page of an airport's arrivals on record for one airport-local day, landed and cancelled flights included (coverage on_record: the flights GADUIN has a record of, not the airport's full schedule). Each physical flight appears once with its codeshares, ordered by scheduled arrival (unknown schedules last), with origin, scheduled departure, scheduled, estimated and recorded arrival in UTC, status
- `list_airport_movements`: The landings (type arrivals) or takeoffs (type departures) of airline flights at an airport in one airport-local day, read off positions reported by aircraft transponders, not from any airline or airport record. A movement belongs to the day its bracket starts in. Each movement is a bracket, not an instant: it happened between earliest_utc and latest_utc, the last position certainly in the air (at
- `get_station_board`: Departures and arrivals at a railway station found by name or station code: the trains still to come by default, or every train of a station-local day with window day (the default when date is given). For each train, the other end of its journey, scheduled and recorded times in UTC, expected times and platforms where the railway publishes them, status, delay, operator and, when one is open, a link
- `search_stations`: Finds railway stations by name or public code among every station a stored train calls at, on every network GADUIN reads, whether or not it has a page on gaduin.com: name, public code (null where the railway has only an internal identifier: then pass the name with network to get_station_board), network, country, coordinates, time zone and how it matched. Matches rank by public code (or the railway
- `get_train_status`: Every run of a train number on one service date with every calling point: scheduled, expected and recorded arrival and departure in UTC, platform where stated, cancellations, per-stop delay, and the railway's stated reason for a delay or cancellation in its own words. Expected times appear only on networks whose operator publishes live expected times, and only while the run is not stale (updated i
- `get_rail_punctuality`: Arrival punctuality of one operator, station or route (origin and destination station codes, one row per operator running it, counting only arrivals at its final destination), summed over the calendar days ending at the newest settled service date: calls (arrival calls with a recorded outcome, arrived or cancelled), on_time (less than 5 minutes late), within_15 (less than 15 minutes late, on_time 
- `list_chokepoints`: Every maritime chokepoint with a published daily ship count (Suez, Panama, Hormuz, Malacca and more), lowest share of normal first, then those unknown or not rated: slug, name, the unit counted, status (open, elevated, disrupted, closed, not_rated when too few ships a day to judge, or unknown), the mean of the last 7 calendar days to latest_date as a share of normal, normal and the newest day behi
- `get_chokepoint_status`: Ship traffic through one maritime chokepoint as of its latest published count: status, the mean of the last 7 calendar days to latest_date against normal and how many of those days are published, the newest daily count, how many final weeks it has been under 85% of normal, since when and against which normal, the last 8 weeks with their share of normal (figures only once a week is final), the last
- `list_ports`: Every port whose own published list of vessel arrivals and departures GADUIN reads, by UN/LOCODE, with its name, country, coordinates, time zone, when its list was last read and found up to date, and whether that is current (within current_within_minutes). Only these ports have a board (get_port_board) or appear in vessel port calls (get_vessel_port_calls); a port missing here is one GADUIN does n
- `get_port_board`: One port-local day of a port's own movement list: every vessel arrival and departure as the port lists it, with vessel name, IMO, MMSI and call sign as listed, status, and expected and recorded times in UTC. An arrival is placed by its recorded arrival (else the arrival the list expects), a departure by its recorded departure. What a recorded arrival means differs by port: instant_kind says whethe
- `get_vessel_port_calls`: One vessel's calls, by IMO number, as the movement lists of the ports GADUIN reads recorded them, newest first: port, vessel name, MMSI and call sign as listed, status, expected and recorded arrival (instant_kind says whether it is the port entry or the berthing) and recorded departure in UTC, each call as the port's newest word on it that still names this IMO. Only the ports list_ports lists appe

## FAQ

### Do I need an account?

Not for most tools. Positions and balance need an API key.

### Can the assistant place trades?

No. All tools are read-only and trading happens on the website.

### What are the rate limits?

30 requests a minute per address without a key, and 1 request per second with a key.

### Which market categories exist?

Flight, train and ship.

### Is Gaduin free?

Yes. Gaduin is free to use.

### How do I add Gaduin to Claude Code?

Run this command in your terminal: claude mcp add --transport http gaduin https://gaduin.com/mcp

### What are the best alternatives to Gaduin?

The closest alternatives to Gaduin are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Lane Cost freight rates and Zentria Flow.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Lane Cost freight rates](https://ai-powered.com/mcp/lane-cost-freight-rates): Lane Cost freight rates is a free MCP server for freight and logistics.
- [Zentria Flow](https://ai-powered.com/mcp/zentria-flow): Zentria Flow is a freemium MCP server for freight and logistics.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Cofinal](https://ai-powered.com/mcp/cofinal): Cofinal is a paid MCP server for freight and logistics.

---
Source: https://ai-powered.com/mcp/gaduin
