Izmir Ulaşım

This MCP server provides live İzmir public transit data to AI assistants, enabling natural language queries about real-time bus positions, routes, stops, and related travel information. It connects to the city’s open data sources and exposes a set of tools you can use through compatible MCP clients to ask questions and receive actionable results.

How to use

You interact with the İzmir Ulaşım MCP Server through an MCP client such as Claude Desktop or Cursor. Use the available tools to query real-time transit data, filter results by line or stop, search for stops or stations, and retrieve schedules. Each tool is designed to answer a concrete question, like which buses are approaching a given stop, where all buses on a line currently are, or when a specific line will next reach a particular stop.

To perform common tasks, call the corresponding tools through your MCP client. For example, you can ask the assistant to pull the approaching buses for a stop, find all lines that serve a stop name, or fetch IZBAN and metro schedules. The tools are meant to integrate with natural language prompts, returning structured information you can act on.

How to install

Prerequisites: You need Python 3.11 or newer and a working runtime for the following dependencies.

Install Python packages and run required setup steps as follows. Ensure you run these commands in a terminal with appropriate permissions.

Clone or download the MCP server package and navigate into its directory.

Install dependencies and set up the environment by running the following commands in order.

uv sync

pip install -r requirements.txt

MCP client configuration

Configure your MCP client to connect to the İzmir Ulaşım MCP Server using one of the provided runtime options. You can run the server locally via Python or use NPX to run a packaged MCP client.

{
  "mcpServers": {
      "izmir_ulasim": {
      "command": "python",
      "args": ["path\\to\\izmir_ulasim_main.py"]
  }
  }
}

MCP client configuration (npm option)

{
  "mcpServers": {
    "izmir_ulasim_npm": {
    "command": "npx",
    "args": ["-y", "izmir-ulasim-mcp"]
  }
  }
}

Available tools

duraga_yaklasan_otobusleri_getir

Returns information about all buses that are currently approaching a specified bus stop by stop_id.

hattin_anlik_otobus_konumlarini_getir

Retrieves the real-time location data for all buses on a given line identified by line_id.

hattin_duraga_yaklasan_otobuslerini_getir

Fetches buses that are approaching a specific stop on a particular line (line_id, stop_id).

durak_ara

Searches for bus stops whose names contain the provided text fragment.

izban_istasyon_ara

Searches IZBAN stations by a text match in the station name.

izban_sefer_saatlerini_getir

Provides IZBAN departure times between two specified stations.

izban_tutar_hesapla

Calculates IZBAN journey cost using the Gittiğin Kadar Öde system given start, end, and transfers.

hat_ara

Finds bus lines whose names or routes match the given text fragment.

hat_sefer_saatlerini_ara

Retrieves the timetable for a specific bus line.

hat_guzergah_koordinatlarini_getir

Returns the route coordinates (latitude/longitude) for a given bus line.

hat_detaylarini_ara

Fetches detailed information about lines, including operation hours for those matching the given text.

en_yakin_duraklari_bul

Finds the nearest bus stops or IZBAN stations to a given latitude/longitude and distance type.

konumumu_al

Obtains the user’s precise geographic location from the browser.

metro_istasyonlarini_getir

Lists all stations of the İzmir metro network.

metro_sefer_saatlerini_getir

Retrieves all scheduled metro times.

metro_istasyonlari_arasi_mesafe_hesapla

Calculates the distance in meters between two metro stations.

tramvay_hatlarini_getir

Lists all tram lines for İzmir tram system.

tramvay_istasyonlarini_getir

Gets all stations for a specified tram line.

tramvay_seferlerini_getir

Fetches tram departures for a given tram line.

karsiyaka_tram_duraklar_arasi_mesafe_hesapla

Calculates distance in meters between two Karşıyaka tram stations.

konak_tram_1_duraklar_arasi_mesafe_hesapla

Calculates distance between two Konak tram stations on the land side.

konak_tram_2_duraklar_arasi_mesafe_hesapla

Calculates distance between two Konak tram stations on the sea side.

cigli_tram_duraklar_arasi_mesafe_hesapla

Calculates distance between two Çiğli tram stations.