BinaSmart

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.

{
  "type": "object",
  "properties": {
    "pickup": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "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",
      "minLength": 2,
      "maxLength": 120,
      "description": "Drop-off: a place name in Addis Ababa (e.g. \"Edna Mall\", \"Bole Airport\", \"Piassa\") or \"lat,lng\" like \"9.0108,38.7578\"."
    }
  },
  "required": [
    "pickup",
    "dropoff"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "tier": {
      "type": "string",
      "enum": [
        "moto",
        "bajaj",
        "economy",
        "comfort",
        "xl"
      ],
      "description": "Vehicle tier from quote_ride"
    },
    "pickup": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "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",
      "minLength": 2,
      "maxLength": 120,
      "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",
      "minLength": 1,
      "maxLength": 60,
      "description": "Rider's name (or the booker's name when booking for someone else)"
    },
    "rider_phone": {
      "type": "string",
      "minLength": 9,
      "maxLength": 20,
      "description": "Ethiopian mobile: 09XXXXXXXX or +2519XXXXXXXX (any number if booking for someone else)"
    },
    "payment_method": {
      "type": "string",
      "enum": [
        "cash",
        "chapa"
      ],
      "description": "cash (default) or chapa (telebirr/card link)"
    },
    "passenger_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Book for someone else: the passenger's name (the driver calls the passenger)"
    },
    "passenger_phone": {
      "type": "string",
      "minLength": 9,
      "maxLength": 20,
      "description": "Book for someone else: the passenger's Ethiopian mobile (09… or +2519…)"
    }
  },
  "required": [
    "tier",
    "pickup",
    "dropoff",
    "rider_name",
    "rider_phone"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "ride_id": {
      "type": "string",
      "minLength": 5,
      "maxLength": 40
    },
    "rider_phone": {
      "type": "string",
      "minLength": 9,
      "maxLength": 20
    }
  },
  "required": [
    "ride_id",
    "rider_phone"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "ride_id": {
      "type": "string",
      "minLength": 5,
      "maxLength": 40
    },
    "rider_phone": {
      "type": "string",
      "minLength": 9,
      "maxLength": 20
    }
  },
  "required": [
    "ride_id",
    "rider_phone"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "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"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results per kind (default 8)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Title (Amharic or English) or genre to filter by; omit for the latest films"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max films, default 20"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Room types, nightly prices (ETB), capacity and amenities for a hotel listed on BinaSmart. Use the slug from search_places (is_hotel = true).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Hotel slug from search_places"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Hospital slug from search_places"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD (default today)"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Guide slug from the list, e.g. tin-registration-ethiopia"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 300,
      "description": "Question or keywords, English or Amharic"
    },
    "k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "How many passages (default 4)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 8.5,
      "maximum": 9.5,
      "description": "Rider latitude, to sort by distance"
    },
    "lng": {
      "type": "number",
      "minimum": 38.4,
      "maximum": 39.2,
      "description": "Rider longitude"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 8.5,
      "maximum": 9.5,
      "description": "Latitude"
    },
    "lng": {
      "type": "number",
      "minimum": 38.4,
      "maximum": 39.2,
      "description": "Longitude"
    }
  },
  "required": [
    "lat",
    "lng"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Public tender and procurement notices in Ethiopia listed on BinaSmart (bina.et/tenders): the issuing organisation, what is wanted, the deadline and days left, budget when stated, and a link to the original notice. Banks, government bodies, NGOs and World Bank–financed projects. Open tenders only unless include_closed is set. Search by keyword (English or Amharic) and filter by category such as Supply, Construction, Consultancy, Services, Transport.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Keyword in the title, organisation or summary — English or Amharic. Omit for the tenders closing soonest."
    },
    "category": {
      "type": "string",
      "maxLength": 40,
      "description": "Category filter, matched loosely: Supply / አቅርቦት, Construction / ግንባታ, Consultancy / ማማከር, Services / አገልግሎት, Transport / ትራንስፖርት, Disposal auction / ሽያጭ ጨረታ. Use list_tender_categories to see what is open now."
    },
    "include_closed": {
      "type": "boolean",
      "description": "Include tenders whose deadline has passed (default false)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max tenders, default 20"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The full text of a single tender notice on BinaSmart, by its slug from list_tenders: requirements, bid bond, where and when to submit, and the link to the original notice.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Tender slug from list_tenders"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The categories of tender open on BinaSmart right now and how many are in each — useful before calling list_tenders with a category filter.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Recent articles from BinaSmart news (bina.et/news), mostly in Amharic: technology, business, law, real estate, construction and employment in Ethiopia. Returns the headline, a short excerpt and the url — call get_news_article for the full text.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Keyword in the headline or excerpt, English or Amharic. Omit for the newest articles."
    },
    "category": {
      "type": "string",
      "maxLength": 40,
      "description": "Category filter, matched loosely: ቴክኖሎጂ technology, ንግድ business, ሕግ law, ሪል እስቴት real estate, ግንባታ construction, ቅጥር employment, መመሪያ guides."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max articles, default 15"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The full text of a single BinaSmart news article by its slug from list_news.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Article slug from list_news"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Open job vacancies in Ethiopia listed on BinaSmart (bina.et/jobs): the job title, the company posting it, the city, the deadline and days left, salary and requirements where the advert states them. Thousands of vacancies from Ethiopian job boards and employers, refreshed every morning. Search by keyword in English or Amharic, and filter by field of work (banking, accounting, engineering, it, health, education, sales, ngo, logistics, admin, hospitality, construction, agriculture, legal, security, media) or by city. Open vacancies only unless include_closed is set.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Keyword in the job title, summary or company name — English or Amharic. Omit for the vacancies closing soonest."
    },
    "field": {
      "type": "string",
      "maxLength": 30,
      "description": "Field of work: banking, accounting, engineering, it, health, education, sales, ngo, logistics, admin, hospitality, construction, agriculture, legal, security, media. Use list_job_fields to see what is open now."
    },
    "city": {
      "type": "string",
      "maxLength": 40,
      "description": "City, e.g. Addis Ababa, Adama, Hawassa, Bahir Dar, Dire Dawa"
    },
    "include_closed": {
      "type": "boolean",
      "description": "Include vacancies whose deadline has passed (default false)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max vacancies, default 20"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The full advert for a single vacancy on BinaSmart, by its slug from list_jobs: the duties and requirements as the employer wrote them, how to apply, and the company behind it with its address when we hold one.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 140,
      "description": "Job slug from list_jobs"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The fields of work with open vacancies on BinaSmart right now and how many are in each, plus the cities hiring most — useful before calling list_jobs with a field or city filter.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A company listed on BinaSmart: what it does, its address and location when we hold them, and every vacancy it has posted. By employer slug from list_jobs or get_job.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Employer slug, e.g. from list_jobs employer_url"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}