ishigaki.info
Home › About › Developers
About

Ishigaki ferry data: JSON API and MCP server

The data behind this site, free to use with a link back: today's sailing status, the next boats, an island-day planner, the seven routes and the cancellation record. One MCP endpoint gives AI assistants the same answers.

MCP server

Endpoint https://ishigaki.info/mcp, Streamable HTTP, no key, no session. Add it to Claude, Cursor or any MCP client:

{
  "mcpServers": {
    "ishigaki": {
      "type": "http",
      "url": "https://ishigaki.info/mcp"
    }
  }
}

Ferry tools: ferry_status (today, per route and operator), next_ferries (route, direction, after HH:MM), plan_island_day (up to three islands, minutes on each, earliest start), ferry_cancellation_history (per route since 7 November 2026) and list_routes. Trip tools: which_island (ranks the six islands for your time, interests, month, children and sea), island_guide (a recommended day on one island) and best_time (month by month: weather normals, typhoons, jellyfish, holiday peaks, festivals). All tools are read-only and need no personal data. Every answer repeats that the operators' pages are the authority.

In ChatGPT: Settings, Apps, Advanced, developer mode, then create an app with the endpoint above. In Claude: Settings, Connectors, Add custom connector, with the same URL.

JSON endpoints

EndpointReturns
/api/statusToday's status per route: anei and ykf each ok, partial, cancelled or null (not posted yet). Cached 15 minutes.
/api/next?route=taketomi&dir=out&after=09:00&n=3Next scheduled boats in Japan time, operator, notes, fares. dir=back for the return.
/api/plan?islands=taketomi,kohama&stay=120&start=07:00The island-hopping planner: out, back, time on each island, or why the day does not work.
/api/history?months=3&route=haterumaCancellation record: worst reading per day and operator, with a per-route summary.
/api/day?date=YYYY-MM-DDOne day's readings: first and last reading time, per-operator worst and latest, status changes with times.
/api/routesThe seven routes with operators, crossing times, boats a day, first and last boat.
/data/ferries.jsonThe complete timetable file: every sailing, both operators, fares, validity dates and source addresses.

Route ids: taketomi, kohama, kuroshima, iriomote-ohara, iriomote-uehara, hatoma, hateruma.

Where the data comes from

Times are transcribed from the operators' published timetables (Anei Kanko PDF valid to 2027-03-31, YKF PDF valid to 2027-02-28) and checked against the live YKF site and the Anei PDF before every publish; see how the data is checked. Status comes from Anei's and YKF's status pages. The cancellation record starts on 7 November 2026 and is read every 20 minutes between 06:00 and 20:00 Japan time.

Terms