# Developers and AI agents

> DailyIndonesia's free, read-only Indonesia travel data for apps and AI assistants: MCP server, REST API, llms.txt.

We publish our Indonesia travel data for apps and AI assistants: live arrivals and departures at Indonesian airports, things to do with prices, restaurants, destination guides and eSIM plans. Everything below is free, read-only and needs no key.

## When to use DailyIndonesia

- A traveller asks whether a flight to, from or within Indonesia is on time, or which terminal, gate or baggage belt it uses.
- Someone planning a trip to Bali, Lombok, Java or elsewhere in Indonesia wants things to do with prices, a restaurant, or where to go.
- Someone needs an eSIM for Indonesia.

## MCP server

Address: `https://dailyindonesia.com/mcp` (Streamable HTTP, no sign-in). Add it to an MCP client such as Claude, ChatGPT or Cursor:

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

Tools (all read-only):

- `list_airports`: Indonesian international airports with IATA/ICAO codes, city, time zone, whether we keep a live board, and the airport page.
- `get_live_flights`: Upcoming and recent arrivals or departures at an Indonesian airport from our saved live board: flight number, airline, route, scheduled and expected local time, status, terminal, gate, baggage belt, flight page. Optional flight filter (e.g. "GA 404").
- `search_things_to_do`: Tours, attraction tickets and day trips in Indonesia (Tiqets, Klook) with from-prices and ratings, best rated first. Filter by city (Bali, Ubud, Jakarta, Lombok, Yogyakarta...) and words.
- `search_restaurants`: Restaurants in Indonesia by name or words, area (e.g. bali, ubud, seminyak, canggu), cuisine (e.g. balinese, italian), with filters for table booking on DailyIndonesia, walk-ins and current offers. Returns rating, price level, cuisines and the restaurant page.
- `get_restaurant`: One restaurant: address, opening hours, menu, rating, price, photos, whether it takes bookings or walk-ins, and its page (where the user can book a table).
- `list_destinations`: Destination guides in Indonesia grouped by region (for example Bali: Ubud, Seminyak, Canggu, Uluwatu), with their paths for get_destination.
- `get_destination`: One destination guide: introduction, places inside it, photos and links to things to do, hotels and restaurants there.
- `compare_esims`: Indonesia eSIM plans from Airalo and Saily: data, days and price in USD, fair-use notes, any discount code, and the link to buy through our page.
- `read_page`: Any dailyindonesia.com page (guide, airport, activity, restaurant, flight) as Markdown. Use for travel guides such as "Bali trip cost" or "best time to visit Bali".

Server card: [/.well-known/mcp/server-card.json](https://dailyindonesia.com/.well-known/mcp/server-card.json).

## REST API

OpenAPI 3.1 description: [https://dailyindonesia.com/openapi.json](https://dailyindonesia.com/openapi.json). Base address: `https://dailyindonesia.com/wp-json/di/v1`.

- `GET /airports`: airports and which have live boards
- `GET /airports/{iata}/board?direction=arrivals`: live board, for example DPS (Bali)
- `GET /things-to-do?city=ubud&q=rafting`: activities with prices
- `GET /restaurants?area=seminyak&cuisine=balinese&book=1`: restaurants
- `GET /restaurants/{id}`: one restaurant
- `GET /destinations` and `GET /destinations/item?path=bali/ubud`: destination guides
- `GET /esim`: Airalo and Saily plans for Indonesia

Example:

```
curl "https://dailyindonesia.com/wp-json/di/v1/airports/DPS/board?direction=arrivals"
```

Answers are JSON: `{"ok": true, "data": ...}`. Errors are JSON too: `{"ok": false, "error": {"code": "not_found", "message": "..."}}` with HTTP 404, or 429 when there are too many requests.

## Limits and fair use

- 60 requests a minute per connection.
- Flight boards are saved on a schedule (Bali every hour) and are not a complete daily schedule; show when the board was updated and ask travellers to confirm with their airline.
- Please link to our page for each item (the `url` field). Bookings are made with our partners through those pages and cost the traveller nothing extra.

## Other files for AI assistants

- [/llms.txt](https://dailyindonesia.com/llms.txt): site guide with live flights
- [/airports/llms.txt](https://dailyindonesia.com/airports/llms.txt): all saved airport boards
- Every page as Markdown: add `.md` to its address, for example [/index.md](https://dailyindonesia.com/index.md)
- [Agent skill](https://dailyindonesia.com/.well-known/agent-skills/index.json), [ARD catalog](https://dailyindonesia.com/.well-known/ard.json), [API catalog](https://dailyindonesia.com/.well-known/api-catalog)

## Contact

Questions or a higher limit: [contact@dailyindonesia.com](mailto:contact@dailyindonesia.com).
