get-eshot-lines
Search ESHOT bus lines by number or name and return matching line records
LABSCO SUMMARY
Each mode keeps its own identifiers, so a trip across two of them is two lookups joined by hand.
İZBAN works from station IDs, ESHOT from durakId and hatNo, trams from a seferId, ferries from iskeleId and gunId, and nothing here routes across modes — an agent planning bus to train resolves each leg separately. What the live layer does give you is position rather than promise: get-line-bus-locations and the two approaching-bus tools report where vehicles actually are, which is a different question from what the timetable says.
What it is
A client for İzmir's municipal transport data, with 19 tools spanning the İZBAN suburban railway, ESHOT buses, the metro, the tram network, train stations and ferries.
What you get
- İZBAN: get-izban-stations for the station list with IDs, get-izban-departures between two stations, and get-izban-fare-tariff, which factors in transfer status and HTT card usage.
- ESHOT search: get-eshot-stations by name or address, get-eshot-lines by number or name, and get-nearby-stations-by-coords with inCoordSys and outCoordSys for whichever coordinate system you are working in.
- Live bus positions: get-line-bus-locations for every bus on a line, get-line-approaching-buses for one line at one stop, and get-station-approaching-buses for everything approaching a stop.
- Metro and tram: get-metro-stations with order and location data, get-metro-sefer-frequencies, get-tram-lines, get-tram-stations-by-sefer-id and get-tram-sefer-frequency-by-sefer-id.
- Ferries: get-ferry-piers covering ferry and car-ferry piers, get-ferry-working-days, get-ferry-timetables by departure, arrival and day type, and get-ferry-timetables-by-pier.
- get-train-stations for the city's gar locations with their info.
Requirements
Nothing — no account, no key.
Setup effort
One command — npx izmir-mcp
USE CASES
01
Working out when the next bus reaches the stop you are standing at
Find the stop from coordinates or a name, then ask what is currently approaching it rather than what the timetable promised.
02
Pricing an İZBAN journey including the transfer
The fare tool takes transfer status and HTT card usage as inputs, so the number it returns is the one that will actually be charged.
03
Planning around a ferry crossing
Ferry service varies by day type, so the working-days list and the pier list come before the timetable is worth reading.
04
Checking how often the metro or tram runs on a route
Frequency is a separate read from the station list on both networks, and the tram's is keyed on the trip rather than the line.
05
Following a whole bus line rather than one stop
Line search resolves the number, and the position tool then returns every bus currently running it.
19 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get-eshot-stations
Search ESHOT stops by name or address and return matching station records
get-ferry-piers
Fetch ferry and car ferry pier information.
get-ferry-timetables
Fetch ferry timetables for given departure, arrival, day type, and detail.
get-ferry-timetables-by-pier
Fetch ferry timetables for a specific pier and day.
get-ferry-working-days
Fetch ferry working days.
get-izban-departures
Get scheduled departures from one İZBAN station to another
get-izban-fare-tariff
Calculate the fare/price for an İZBAN suburban train journey between two stations. Factors in transfer status and HTT card usage for accurate pricing.
get-izban-stations
Retrieve the full list of İZBAN stations with IDs and names
get-line-approaching-buses
Get buses of a line approaching a specific stop
get-line-bus-locations
Get real-time locations of all buses on a given line
get-metro-sefer-frequencies
Fetch metro sefer (trip) frequencies in Izmir.
get-metro-stations
Fetch all metro stations in Izmir, including order and location data.
get-nearby-stations-by-coords
Get nearby ESHOT bus stations by geographic coordinates. Useful for finding the closest bus stops to a specific location in Izmir.
get-station-approaching-buses
Get real-time positions of buses approaching a specific stop
get-train-stations
Fetch all train stations (gar) in Izmir, including location and info.
get-tram-lines
Fetch all tramvay (tram) lines in Izmir.
get-tram-sefer-frequency-by-sefer-id
Fetch tramvay (tram) sefer (trip) frequency for a given sefer (trip) ID.
get-tram-stations-by-sefer-id
Fetch tramvay (tram) stations for a given sefer (trip) ID.
BEFORE YOU INSTALL
What to know first
Tools you get
19 tools when we connected.
Requires
- npx on PATH
- Node.js 18+
CONTEXT COST
Light Standing cost
Rated by the size of the 19 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"izmir-mcp": {
"command": "npx",
"args": [
"izmir-mcp"
]
}
}
}npx
TERMINAL
npx izmir-mcp
