İstanbul vapurları, yapay zekâ asistanınız için

Iskelesi'nin verileri bütün yapay zekâ asistanlarına açık. Asistanınızı bağlayın; Kadıköy'den bir sonraki vapurun kaçta kalktığını, Eminönü'nden Adalar'a nasıl gidileceğini ya da Galata Köprüsü'nden gördüğünüz vapurun hangisi olduğunu sorun.

Bu, herkese açık bir Model Context Protocol (MCP) sunucusudur: ücretsiz, salt okunur; anahtar da hesap da gerekmez. Adresi:

https://api.iskelesi.com/mcp

Bağlanın

Claude

claude.ai'de ya da Claude uygulamalarında: Settings → Connectors → Add custom connector. Adını Iskelesi koyun ve yukarıdaki adresi yapıştırın. Yetkilendirme gerekmez.

Claude Code

claude mcp add --transport http iskelesi https://api.iskelesi.com/mcp

Cursor

~/.cursor/mcp.json dosyasına ekleyin:

{ "mcpServers": { "iskelesi": { "url": "https://api.iskelesi.com/mcp" } } }

VS Code

.vscode/mcp.json dosyasına ekleyin:

{ "servers": { "iskelesi": { "type": "http", "url": "https://api.iskelesi.com/mcp" } } }

Model Context Protocol'ü HTTP üzerinden konuşan diğer bütün istemciler de aynı şekilde çalışır: adresi verin ve "Streamable HTTP" seçin.

Asistanınız neler yapabilir

Sekiz araç var; hepsi salt okunur. Her biri, modelin doğrudan okuyabileceği kısa bir yanıt ve aynı bilgiyi yapılandırılmış JSON olarak döndürür. Araçlar Türkçe sorularla da çalışır; yanıt metinleri İngilizcedir.

AraçNeyi yanıtlarÖrnek soru
search_piersAda, işletmeciye, yakaya ya da bir noktaya yakınlığa göre iskeleler"Mısır Çarşısı'na en yakın iskele hangisi, oradan kimler kalkıyor?"
next_departuresBir iskeleden sıradaki kalkışlar; nereye gittikleri, nerelere uğradıkları"Karaköy'den Kadıköy'e bir sonraki vapur kaçta?"
plan_tripİki iskele arasında direkt seferler; daha hızlıysa tek aktarmalı yolculuk"Ortaköy'deyim. Öğleden sonra Büyükada'ya nasıl giderim?"
boats_nowVapurlar şu anda ya da günün herhangi bir saatinde nerede"Şu anda Boğaz'ı geçen bütün vapurları göster."
boat_journeyTek bir seferin uğradığı iskeleler ve saatleri"Eminönü'nden 17:00'de kalkan Turyol Karaköy'e uğruyor mu?"
timetableBir iskelenin ya da bir hattın bütün günlük tarifesi"Pazar günü Heybeliada'dan dönen son vapur kaçta?"
list_operatorsİşletmeciler, kendi tarife sayfaları ve logoları"Iskelesi'nde hangi vapur işletmecilerinin tarifesi var?"
data_sourcesHer verinin nereden geldiği ve en son ne zaman okunduğu"Kullandığın Şehir Hatları tarifesi ne kadar güncel?"

İskele adlarında esnek davranır. kadikoy, Kadıköy ve KADIKÖY İSKELESİ aynı yeri bulur; eminonu turyol ise Turyol'un Eminönü'ndeki kendi iskelesi demektir.

Veriler hakkında bilmeniz gerekenler

Vapur konumları tahminidir. İstanbul'un vapurları konumlarını yayımlamıyor. Her vapuru tarifesine bakarak hattı üzerinde bir yere koyuyoruz: vaktinde gidiyorsa olması gereken yere. Her konum positionSource: "estimated" olarak işaretlenir ve asistanınıza da bunu söylemesi bildirilir.

Saatler tarifedir, canlı sefer bilgisi değildir. Tarifeleri her gün Şehir Hatları, Turyol, Mavi Marmara ve İDO'dan okuyoruz. Hava muhalefeti seferleri iptal ettirir, tarifeler mevsime göre değişir. Yola çıkmadan önce işletmeciye bakın; her yanıt işletmecinin kendi tarife sayfasına bağlantı verir.

Her seferin uğradığı iskeleler kendine aittir. Turyol'un Eminönü'nden 17:00 seferi hafta içi doğrudan Kadıköy'e gider, hafta sonu Karaköy'e de uğrar. Veri bu ayrımı korur; yanıt, gerçekten bineceğiniz vapur içindir.

Bütün saatler İstanbul saatidir (yıl boyu UTC+03:00) ve saat farkıyla birlikte yazılır.

JSON API de var

Aynı veriler HTTPS üzerinden düz JSON olarak da sunulur; tanımı OpenAPI 3.1 biçimindedir:

Uç noktaNe döndürür
GET /v1/networkİşletmeciler, iskeleler ve hatlar
GET /v1/piers/{id}/departuresBir iskeleden sıradaki kalkışlar
GET /v1/sailings?date=YYYY-MM-DDBir günün bütün seferleri, uğradıkları iskelelerle
GET /v1/vesselsŞu anda seferde olan vapurlar
GET /v1/healthHer veri kaynağı ve en son ne zaman okunduğu

Dil modelleri için bir llms.txt, sunucuları kendi kendine keşfeden MCP istemcileri için de bir sunucu kartı bulunur.

Adil kullanım

MCP sunucusunda üst sınır, IP adresi başına dakikada 600 istektir; aşıldığında yanıt HTTP 429 olur. Yanıtlar önbelleğe alınır; lütfen sürekli sorgulamak yerine cache-control başlığına uyun. Kesintisiz çalışma sözü vermiyoruz: bu, Iskelesi uygulamasının da kullandığı hizmetin ta kendisi. Kullanım koşulları geçerlidir.

Kaynak gösterimi

İskeleler ve hatlar: Kaynak: İBB Açık Veri Portalı. Tarifeler işletmecilerine aittir: Şehir Hatları, Turyol, Mavi Marmara ve İDO. Iskelesi'nin İBB veya herhangi bir işletmeciyle bağlantısı yoktur. Bu verilerle bir şey geliştirirseniz kaynağı belirtin ve kullanıcılarınıza işletmeciye bakmalarını söyleyin.

Sorunuz mu var, yanlış görünen bir şey mi? ferry@iskelesi.com