Yonga.io Turkey EV Charging API

MCP server providing 9 tools from Yonga.io Turkey EV Charging API Yonga Turkey EV Charging MCP gives AI agents structured, enriched access to Turkey's electric-vehicle charging landscape. Data is sourced from EPDK (official), Google Maps, and open platforms, then geocoded and normalised.

Query ~15,000 charging stations and 181 network operators by city, district, connector type (CCS2, Type2, CHAdeMO, Type1, GBT), socket type (AC/DC), and power range. Find stations near any coordinate, inspect individual sockets and operator pricing, and pull per-city charging statistics.

The same server also exposes Turkey's administrative geography — all 81 provinces (il), their districts (ilçe), neighbourhoods (mahalle), and GeoJSON boundary polygons — so agents can resolve locations and render maps without a second data source.

All responses use a consistent JSON envelope ({ data, meta }). A Sanctum bearer token is required for every call.

Features & abilities (all 9 tools)

Group the tools in the listing as below. Tool names are stable snake_case and must not be renamed.

EV charging & networks (5)

Tool	What it does	Key inputs
list_charging_stations	Paginated, filterable station search; returns full station objects + meta.statics aggregates. To get stations of a single network, pass network=slug.	city, district, network, connector_type, socket_type, power_min, power_max, page, limit
get_station_info	One station by numeric id, slug, or station_epdk_id; full detail incl. socket list.	slug
list_networks	Paginated operators (ZES, Eşarj, Trugo…) with contact, URLs, pricing, aggregates.	type, hasPrices, network, page, limit
get_network_info	One operator by id or slug; company details + pricing fields.	slug
find_nearby_stations	Stations within radius km of a point, sorted nearest-first (haversine).	latitude, longitude, radius, limit, filters

Administrative geography (4)

Tool	What it does	Key inputs
list_cities	All 81 provinces (il) with plate code, centre coords, bounding box; Turkish-normalised search.	search, page, limit
get_city	One city by slug/plaka/tkgm_id/id; coords, bounds, charging totals. Use populate to embed districts, GeoJSON polygon, or top-networks ranking.	slug, populate (comma-separated: districts, polygon, stats)
list_districts	Districts (ilçe) of a city; the slug must be a city, not a district.	slug, search, populate=polygon
list_mahalles	Neighbourhoods (mahalle) of a district; requires both city and district slug.	slug, district_slug

Highlight bullets (for the listing)

• ~15,000 stations · 181 networks · 81 provinces · socket-level detail
• Geo-search ("near me") with haversine distance ranking
• Filter by connector, AC/DC, power range, network, city, district
• Operator pricing (AC / DC fast / DC ultra-fast)
• Full Turkish administrative geography + GeoJSON polygons
• Consistent { data, meta } JSON envelope; same shape as the REST API
• Enriched beyond raw EPDK data (geocoding, Google Places)

Example prompts (for "Usage" section)

"List DC CCS2 charging stations in Istanbul, 25 per page." → list_charging_stations "Find charging stations within 5 km of 41.0082, 28.9784." → find_nearby_stations "Show pricing and details for the ZES network." → get_network_info "List all ZES stations in Ankara." → list_charging_stations (network="zes", city="ankara") "How many charging stations and networks does Ankara have?" → list_charging_stations (filter: city=ankara) "List the districts of Ankara." → list_districts "Give me the GeoJSON boundary of Izmir." → get_city (populate=polygon) Türkçe also works (the model calls the same English tool names):

"İstanbul'da DC şarj istasyonlarını listele." "Ankara için şarj istatistiklerini getir."