Istanbul's ferries for your AI agent
Iskelesi's data is open to any AI agent. Connect one and ask it when the next boat leaves Kadıköy, how to get from Eminönü to the islands, or which ferry you can see from the Galata Bridge.
It's a public Model Context Protocol (MCP) server: free, read-only, and with no key or account. This is its address:
https://api.iskelesi.com/mcp
Connect
Claude
In claude.ai or the Claude apps: Settings → Connectors → Add custom connector. Name it Iskelesi and paste the address above. There's nothing to authorise.
Claude Code
claude mcp add --transport http iskelesi https://api.iskelesi.com/mcp
Cursor
Add to ~/.cursor/mcp.json:
{ "mcpServers": { "iskelesi": { "url": "https://api.iskelesi.com/mcp" } } }
VS Code
Add to .vscode/mcp.json:
{ "servers": { "iskelesi": { "type": "http", "url": "https://api.iskelesi.com/mcp" } } }
Any other client that speaks the Model Context Protocol over HTTP works the same way: give it the address and choose "Streamable HTTP".
What your agent can do
Eight tools, all read-only. Each returns a short answer a model can read straight off, and the same thing as structured JSON.
| Tool | What it answers | Example question |
|---|---|---|
search_piers | Piers by name, operator, shore, or nearest to a point | "Which pier is nearest the Spice Bazaar, and who sails from it?" |
next_departures | The next boats from a pier, where they go and where they call | "When's the next ferry from Karaköy to Kadıköy?" |
plan_trip | Direct sailings between two piers, or one change when that's quicker | "I'm at Ortaköy. How do I get to Büyükada this afternoon?" |
boats_now | Where the boats are, now or at any time today | "Show me every boat crossing the Bosphorus right now." |
boat_journey | One sailing's stops and times | "Does the 17:00 Turyol from Eminönü stop at Karaköy?" |
timetable | A whole day from a pier, or along a route | "What's the last boat back from Heybeliada on Sunday?" |
list_operators | The operators, their own timetable pages and logos | "Which ferry companies does Iskelesi have timetables for?" |
data_sources | Where every number comes from and when it was last read | "How fresh is the Şehir Hatları timetable you're using?" |
Pier names are forgiving. kadikoy, Kadıköy and KADIKÖY İSKELESİ all work, and eminonu turyol means Turyol's own pier at Eminönü.
What you should know about the data
Boat positions are estimates. Istanbul's ferries don't publish their positions. We place each boat along its route from its timetable: where it should be if it's running on time. Every position is marked positionSource: "estimated", and your agent is told to say so.
Times are timetables, not live running. We read them from Şehir Hatları, Turyol, Mavi Marmara and İDO, daily. Weather cancels ferries, and timetables change with the season. Check with the operator before you travel; every answer links to the operator's own timetable.
Each sailing has its own stops. Turyol's 17:00 from Eminönü goes straight to Kadıköy on weekdays and calls at Karaköy at the weekend. The data keeps that, so the answer is for the boat you'll actually board.
All times are Istanbul time, UTC+03:00 all year, and are written with the offset.
A JSON API too
The same data is plain JSON over HTTPS, described in OpenAPI 3.1:
| Endpoint | What it returns |
|---|---|
GET /v1/network | Operators, piers and routes |
GET /v1/piers/{id}/departures | Next departures from a pier |
GET /v1/sailings?date=YYYY-MM-DD | Every sailing of one day, with its stops |
GET /v1/vessels | Boats on the water now |
GET /v1/health | Each data source and when it was last read |
There's an llms.txt for language models and a server card for MCP clients that discover servers by themselves.
Fair use
600 requests a minute per IP address is the ceiling on the MCP server; over that, the answer is HTTP 429. Responses are cached, so please honour cache-control instead of polling. There's no uptime promise: this is the same service the Iskelesi app runs on. The terms of use apply.
Credit
Piers and routes: Kaynak: İBB Açık Veri Portalı. Timetables belong to their operators: Şehir Hatları, Turyol, Mavi Marmara and İDO. Iskelesi isn't affiliated with İBB or any operator. If you build on this, keep the credit and tell your users to check with the operator.
Questions, or something that looks wrong? ferry@iskelesi.com