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.

ToolWhat it answersExample question
search_piersPiers by name, operator, shore, or nearest to a point"Which pier is nearest the Spice Bazaar, and who sails from it?"
next_departuresThe 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_tripDirect 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_nowWhere the boats are, now or at any time today"Show me every boat crossing the Bosphorus right now."
boat_journeyOne sailing's stops and times"Does the 17:00 Turyol from Eminönü stop at Karaköy?"
timetableA whole day from a pier, or along a route"What's the last boat back from Heybeliada on Sunday?"
list_operatorsThe operators, their own timetable pages and logos"Which ferry companies does Iskelesi have timetables for?"
data_sourcesWhere 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:

EndpointWhat it returns
GET /v1/networkOperators, piers and routes
GET /v1/piers/{id}/departuresNext departures from a pier
GET /v1/sailings?date=YYYY-MM-DDEvery sailing of one day, with its stops
GET /v1/vesselsBoats on the water now
GET /v1/healthEach 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