MCP-Server

BinaSmart

et.bina/binasmart
Karten & Standort Reisen & Hospitality Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Supports rides and shared commutes in Addis Ababa, searches local places, and provides hotel, hospital, event, film, and Ethiopia guide information.

cancel_ride
Cancel a ride
Cancels a BinaSmart ride that has not started yet. Confirm with the user first. Needs the ride id and the rider phone used to book.
Destruktiv Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ride_id', 'rider_phone'], 'properties': {'ride_id': {'type': 'string', 'maxLength': 40, 'minLength': 5}, 'rider_phone': {'type': 'string', 'maxLength': 20, 'minLength': 9}}, 'additionalProperties': False}
find_pool_groups
Find BinaPool cars filling near a point
Cars currently filling within about 2.5 km of a point in Addis Ababa: destination, seats left, seat price, women-only flag, and a share url (https://bina.et/pool/<id>) the rider can open to join. Driver-opened cars at stations are listed first. Requires lat/lng.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'maximum': 9.5, 'minimum': 8.5, 'description': 'Latitude'}, 'lng': {'type': 'number', 'maximum': 39.2, 'minimum': 38.4, 'description': 'Longitude'}}, 'additionalProperties': False}
get_ethiopia_guide
Digital Ethiopia guide
BinaSmart's bilingual (Amharic + English) step-by-step guides to Ethiopian government and banking services: Fayda ID, telebirr, CBE Birr, e-Passport, eVisa, TIN, business licence, VAT/TOT, customs, driving licence, car import, Yellow Card, bank account, birth/marriage certificate, utility bills, Labor ID and LMIS registration and the COC occupational competency certificate (Overseas Employment Proclamation 1389/2025), rental agreements, tenant screening. Call with no slug to list guides; call with a slug for the full text. The guides hold the correct official names and links — prefer them over guessing.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'type': 'string', 'description': 'Guide slug from the list, e.g. tin-registration-ethiopia'}}, 'additionalProperties': False}
get_hospital_departments
Hospital departments and slots
Departments of a hospital listed on BinaSmart with consultation fee (ETB), doctors, hours, floor/room and appointment slots left for a date. Use the slug from search_places (is_hospital = true).
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'YYYY-MM-DD (default today)'}, 'slug': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Hospital slug from search_places'}}, 'additionalProperties': False}
get_hotel_rooms
Hotel rooms and prices
Room types, nightly prices (ETB), capacity and amenities for a hotel listed on BinaSmart. Use the slug from search_places (is_hotel = true).
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Hotel slug from search_places'}}, 'additionalProperties': False}
get_ride_status
Ride status
Current status of a BinaSmart ride (dispatching, assigned, arriving, arrived, ontrip, completed, cancelled) with driver name, vehicle and plate once assigned. Needs the ride id and the rider phone used to book.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ride_id', 'rider_phone'], 'properties': {'ride_id': {'type': 'string', 'maxLength': 40, 'minLength': 5}, 'rider_phone': {'type': 'string', 'maxLength': 20, 'minLength': 9}}, 'additionalProperties': False}
list_events
Upcoming events
Upcoming films, concerts, theatre and events on BinaSmart in Addis Ababa with venue, hall, start time, prices per tier and seats left. Seats are chosen and paid at the url returned (Chapa or at the counter); the ticket is a QR code.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
list_films
Amharic films to watch online
Licensed Amharic (Ethiopian) films that can be watched online on BinaSmart Watch (bina.et/watch): title in Amharic and English, year, genre, whether it is free or rented for 48 hours (ETB), and the watch url. Free titles are public YouTube releases played through the YouTube player; rentals need Chapa. Optional search by title or genre.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max films, default 20'}, 'query': {'type': 'string', 'maxLength': 60, 'description': 'Title (Amharic or English) or genre to filter by; omit for the latest films'}}, 'additionalProperties': False}
list_pool_corridors
BinaPool corridors and seat prices
BinaPool (ጋራ ጉዞ) is BinaSmart's shared commute in Addis Ababa: up to four riders share one Comfort car and pay per seat. Lists the corridors open right now (Megenagna → Bole, CMC → Bole, Megenagna → Kazanchis, Piassa → Kazanchis, Mexico → Kazanchis; inbound until 13:00 Addis time, outbound after) with their stops, the live seat-price ladder (1–4 riders) and cars currently filling. Riders join at https://bina.et/ride?pool=1.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'maximum': 9.5, 'minimum': 8.5, 'description': 'Rider latitude, to sort by distance'}, 'lng': {'type': 'number', 'maximum': 39.2, 'minimum': 38.4, 'description': 'Rider longitude'}}, 'additionalProperties': False}
quote_ride
Quote a BinaSmart ride
Fixed upfront price for a ride inside Addis Ababa, Ethiopia — no surge, cash or telebirr/Chapa. Returns distance, ETA and the fare for every vehicle tier (moto, bajaj, economy, comfort, XL). Call this before request_ride and read the fare to the user.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pickup', 'dropoff'], 'properties': {'pickup': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Pickup: a place name in Addis Ababa (e.g. "Edna Mall", "Bole Airport", "Piassa") or "lat,lng" like "9.0108,38.7578".'}, 'dropoff': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Drop-off: a place name in Addis Ababa (e.g. "Edna Mall", "Bole Airport", "Piassa") or "lat,lng" like "9.0108,38.7578".'}}, 'additionalProperties': False}
request_ride
Book a BinaSmart ride
Books a ride in Addis Ababa at the fixed fare from quote_ride. ALWAYS confirm pickup, drop-off, tier, fare and the rider's Ethiopian phone number with the user before calling. A dispatcher assigns a driver; the rider is contacted on the phone given. Returns the ride id and a live tracking link. To book for someone else (e.g. a relative in Addis while you are abroad), pass passenger_name and passenger_phone; rider_name/rider_phone are then the booker and may be a foreign number.
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tier', 'pickup', 'dropoff', 'rider_name', 'rider_phone'], 'properties': {'tier': {'enum': ['moto', 'bajaj', 'economy', 'comfort', 'xl'], 'type': 'string', 'description': 'Vehicle tier from quote_ride'}, 'pickup': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Pickup: a place name in Addis Ababa (e.g. "Edna Mall", "Bole Airport", "Piassa") or "lat,lng" like "9.0108,38.7578". Prefer the pickup_coords from quote_ride.'}, 'dropoff': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Drop-off: a place name in Addis Ababa (e.g. "Edna Mall", "Bole Airport", "Piassa") or "lat,lng" like "9.0108,38.7578". Prefer the dropoff_coords from quote_ride.'}, 'rider_name': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': "Rider's name (or the booker's name when booking for someone else)"}, 'rider_phone': {'type': 'string', 'maxLength': 20, 'minLength': 9, 'description': 'Ethiopian mobile: 09XXXXXXXX or +2519XXXXXXXX (any number if booking for someone else)'}, 'passenger_name': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': "Book for someone else: the passenger's name (the driver calls the passenger)"}, 'payment_method': {'enum': ['cash', 'chapa'], 'type': 'string', 'description': 'cash (default) or chapa (telebirr/card link)'}, 'passenger_phone': {'type': 'string', 'maxLength': 20, 'minLength': 9, 'description': "Book for someone else: the passenger's Ethiopian mobile (09â\x80¦ or +2519â\x80¦)"}}, 'additionalProperties': False}
search_knowledge
Search BinaSmart knowledge
Semantic search over BinaSmart's knowledge base: every service (BinaRide, BinaPool shared commute, Bina Airport, hotels, cinema, BinaWatch, insurance, flights, property, cars, tenders), the product rules (fixed fares, what is demo, payments), the 24 Digital Ethiopia guides, and practical Addis Ababa knowledge (neighbourhoods, transport hubs, Ethiopian time and calendar, emergency numbers). Returns the best-matching passages with a source url to cite. Use it before answering any question about BinaSmart, Ethiopia paperwork or getting around Addis; never invent a fare or an official portal name.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'k': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'How many passages (default 4)'}, 'query': {'type': 'string', 'maxLength': 300, 'minLength': 2, 'description': 'Question or keywords, English or Amharic'}}, 'additionalProperties': False}
search_places
Search the BinaSmart directory
Find buildings, hotels, hospitals and shops in Addis Ababa listed on BinaSmart (bina.et): cafés, restaurants, pharmacies, banks, gyms, salons, clinics, offices. Returns names (English + Amharic), building and unit, the phone only for shops that have claimed their listing, coordinates when known (usable as pickup/dropoff for quote_ride), and the bina.et page. Hotels and hospitals are flagged — use get_hotel_rooms / get_hospital_departments for details.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max results per kind (default 8)'}, 'query': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Name or part of a name, English or Amharic'}, 'category': {'type': 'string', 'description': 'Shop category filter: cafe | restaurant | pharmacy | retail | service | gym | salon | clinic | bank | office | other'}}, 'additionalProperties': False}
Hinzugefügt
find_pool_groups
17. September 2026 12:39
Hinzugefügt
list_pool_corridors
17. September 2026 12:39
Hinzugefügt
search_knowledge
17. September 2026 12:39
Hinzugefügt
get_ethiopia_guide
17. September 2026 12:39
Hinzugefügt
get_hospital_departments
17. September 2026 12:39
Hinzugefügt
get_hotel_rooms
17. September 2026 12:39
Hinzugefügt
list_films
17. September 2026 12:39
Hinzugefügt
list_events
17. September 2026 12:39
Hinzugefügt
search_places
17. September 2026 12:39
Hinzugefügt
cancel_ride
17. September 2026 12:39
Hinzugefügt
get_ride_status
17. September 2026 12:39
Hinzugefügt
request_ride
17. September 2026 12:39
Hinzugefügt
quote_ride
17. September 2026 12:39