Servers Playground How we check Add a server Log in

BinaSmart

Working · 2.1 s

et.bina/binasmartv1.3.2 Domain verified

Ethiopia: Addis rides, jobs, tenders, hotels, health, homes, cars, news and government guides

Local Services Maps & Travel

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://bina.et/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_ride Destructive

Cancels a BinaSmart ride that has not started yet. A cancellation cannot be undone. Needs the ride id and the rider phone used to book.

ride_idstring, required

Ride id returned by request_ride

rider_phonestring, required

Ethiopian phone number used to book the ride, in the form 09xxxxxxxx or +2519xxxxxxxx

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

BinaSmart MCP server | mcptry

Tools (33)

cancel_ride

Cancels a BinaSmart ride that has not started yet. A cancellation cannot be undone. Needs the ride id and the rider phone used to book.

destructive

Argument	Type	Description
ride_id*	string	Ride id returned by request_ride
rider_phone*	string	Ethiopian phone number used to book the ride, in the form 09xxxxxxxx or +2519xxxxxxxx

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ride_id",
    "rider_phone"
  ],
  "properties": {
    "ride_id": {
      "type": "string",
      "maxLength": 40,
      "minLength": 5,
      "description": "Ride id returned by request_ride"
    },
    "rider_phone": {
      "type": "string",
      "maxLength": 20,
      "minLength": 9,
      "description": "Ethiopian phone number used to book the ride, in the form 09xxxxxxxx or +2519xxxxxxxx"
    }
  },
  "additionalProperties": false
}

find_pool_groups

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.

read-only

Argument	Type	Description
lat*	number	Latitude
lng*	number	Longitude

Input schema (JSON)

{
  "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_employer

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.

read-only

Argument	Type	Description
slug*	string	Employer slug, e.g. from list_jobs employer_url

Input schema (JSON)

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

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

read-only

Argument	Type	Description
slug	string	Guide slug from the list, e.g. tin-registration-ethiopia

Input schema (JSON)

{
  "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

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

read-only

Argument	Type	Description
date	string	YYYY-MM-DD (default today)
slug*	string	Hospital slug from search_places

Input schema (JSON)

{
  "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

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

read-only

Argument	Type	Description
slug*	string	Hotel slug from search_places

Input schema (JSON)

{
  "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_job

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.

read-only

Argument	Type	Description
slug*	string	Job slug from list_jobs

Input schema (JSON)

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

get_news_article

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

read-only

Argument	Type	Description
slug*	string	Article slug from list_news

Input schema (JSON)

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

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

read-only

Argument	Type	Description
ride_id*	string	Ride id returned by request_ride
rider_phone*	string	Ethiopian phone number used to book the ride, in the form 09xxxxxxxx or +2519xxxxxxxx

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ride_id",
    "rider_phone"
  ],
  "properties": {
    "ride_id": {
      "type": "string",
      "maxLength": 40,
      "minLength": 5,
      "description": "Ride id returned by request_ride"
    },
    "rider_phone": {
      "type": "string",
      "maxLength": 20,
      "minLength": 9,
      "description": "Ethiopian phone number used to book the ride, in the form 09xxxxxxxx or +2519xxxxxxxx"
    }
  },
  "additionalProperties": false
}

get_tender

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.

read-only

Argument	Type	Description
slug*	string	Tender slug from list_tenders

Input schema (JSON)

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

list_cinema_showtimes

What is showing in Addis Ababa cinemas this week, from BinaSmart Cinema (bina.et/cinema): each cinema with its address and phone, and each film with its show times and dates as the cinema posted them, with a link to the cinema's own post. Filter by cinema or film title (English or Amharic).

read-only

Argument	Type	Description
film	string	Part of a film title, English or Amharic
cinema	string	Part of a cinema name, e.g. Alem, Century, Edna, Matti

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "film": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a film title, English or Amharic"
    },
    "cinema": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a cinema name, e.g. Alem, Century, Edna, Matti"
    }
  },
  "additionalProperties": false
}

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

read-only

No arguments.

Input schema (JSON)

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

list_films

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.

read-only

Argument	Type	Description
limit	integer	Max films, default 20
query	string	Title (Amharic or English) or genre to filter by; omit for the latest films

Input schema (JSON)

{
  "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_job_fields

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.

read-only

No arguments.

Input schema (JSON)

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

list_jobs

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. Where the assistant shows MCP Apps, the result also appears as job cards with an apply link for each vacancy.

read-only

Argument	Type	Description
city	string	City, e.g. Addis Ababa, Adama, Hawassa, Bahir Dar, Dire Dawa
field	string	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.
limit	integer	Max vacancies, default 20
query	string	Keyword in the job title, summary or company name — English or Amharic. Omit for the vacancies closing soonest.
include_closed	boolean	Include vacancies whose deadline has passed (default false)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 40,
      "description": "City, e.g. Addis Ababa, Adama, Hawassa, Bahir Dar, Dire Dawa"
    },
    "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."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max vacancies, default 20"
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Keyword in the job title, summary or company name — English or Amharic. Omit for the vacancies closing soonest."
    },
    "include_closed": {
      "type": "boolean",
      "description": "Include vacancies whose deadline has passed (default false)"
    }
  },
  "additionalProperties": false
}

list_news

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.

read-only

Argument	Type	Description
limit	integer	Max articles, default 15
query	string	Keyword in the headline or excerpt, English or Amharic. Omit for the newest articles.
category	string	Category filter, matched loosely: ቴክኖሎጂ technology, ንግድ business, ሕግ law, ሪል እስቴት real estate, ግንባታ construction, ቅጥር employment, መመሪያ guides.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max articles, default 15"
    },
    "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."
    }
  },
  "additionalProperties": false
}

list_overseas_agencies

Ethiopian agencies that send domestic workers to GCC countries, approved on BinaSmart/GCC Domestic: name, licence, whether it is in the Ministry of Labor and Skills register, and for each country its GCC partner office (the office families contact). Filter by country: UAE, KSA, Qatar, Kuwait, Bahrain, Oman. Recruitment is through LMIS only (Proclamation 1389/2025).

read-only

Argument	Type	Description
country	string	GCC destination country; omit for all

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "country": {
      "enum": [
        "UAE",
        "KSA",
        "Qatar",
        "Kuwait",
        "Bahrain",
        "Oman"
      ],
      "type": "string",
      "description": "GCC destination country; omit for all"
    }
  },
  "additionalProperties": false
}

list_pool_corridors

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.

read-only

Argument	Type	Description
lat	number	Rider latitude, to sort by distance
lng	number	Rider longitude

Input schema (JSON)

{
  "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
}

list_tender_categories

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

read-only

No arguments.

Input schema (JSON)

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

list_tenders

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.

read-only

Argument	Type	Description
limit	integer	Max tenders, default 20
query	string	Keyword in the title, organisation or summary — English or Amharic. Omit for the tenders closing soonest.
newest	boolean	Newest published first, for "new", "latest", "today" or "this week" (default: closing soonest first). Each tender has published_at, the date that shows whether it is new.
category	string	Category filter, matched loosely: Supply / አቅርቦት, Construction / ግንባታ, Consultancy / ማማከር, Services / አገልግሎት, Transport / ትራንስፖርት, Disposal auction / ሽያጭ ጨረታ. Use list_tender_categories to see what is open now.
include_closed	boolean	Include tenders whose deadline has passed (default false)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max tenders, default 20"
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Keyword in the title, organisation or summary — English or Amharic. Omit for the tenders closing soonest."
    },
    "newest": {
      "type": "boolean",
      "description": "Newest published first, for \"new\", \"latest\", \"today\" or \"this week\" (default: closing soonest first). Each tender has published_at, the date that shows whether it is new."
    },
    "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)"
    }
  },
  "additionalProperties": false
}

list_tv_and_radio

Ethiopian TV channels and radio stations on BinaWatch (bina.et/watch): whether each is live right now with the live programme title and link, its newest videos, and its own website. Filter by TV or radio.

read-only

Argument	Type	Description
kind	string	tv, radio or all (default all)
channel	string	Part of a channel name, e.g. EBS, Fana, Sheger

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "enum": [
        "tv",
        "radio",
        "all"
      ],
      "type": "string",
      "description": "tv, radio or all (default all)"
    },
    "channel": {
      "type": "string",
      "maxLength": 40,
      "description": "Part of a channel name, e.g. EBS, Fana, Sheger"
    }
  },
  "additionalProperties": false
}

list_tv_series

Ethiopian TV drama and comedy series on BinaWatch (bina.et/watch) with the channel that airs them and their newest episodes (title, date and watch link). Search by series title, English or Amharic.

read-only

Argument	Type	Description
query	string	Part of a series title, e.g. Derash or ደራሽ

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a series title, e.g. Derash or ደራሽ"
    }
  },
  "additionalProperties": false
}

quote_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). request_ride books at the fare this returns. Also returns book_url: a one-tap bina.et link with this route and fare for the user to confirm.

read-only

Argument	Type	Description
pickup*	string	Pickup: a place name in Addis Ababa (e.g. "Edna Mall", "Bole Airport", "Piassa") or "lat,lng" like "9.0108,38.7578".
dropoff*	string	Drop-off: a place name in Addis Ababa (e.g. "Edna Mall", "Bole Airport", "Piassa") or "lat,lng" like "9.0108,38.7578".

Input schema (JSON)

{
  "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

Books a ride in Addis Ababa at the fixed fare from quote_ride. It sends a real driver, so it takes the pickup, drop-off, tier, fare and the rider's Ethiopian phone number as the user confirmed them. 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.

Argument	Type	Description
tier*	string	Vehicle tier from quote_ride
pickup*	string	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*	string	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*	string	Rider's name (or the booker's name when booking for someone else)
rider_phone*	string	Ethiopian mobile: 09XXXXXXXX or +2519XXXXXXXX (any number if booking for someone else)
passenger_name	string	Book for someone else: the passenger's name (the driver calls the passenger)

search_cars

Live new and used cars on bina.et/cars from Addis Ababa dealers' and car markets' own websites, checked every week: make, model, year, price, mileage, fuel, gearbox, the dealer with its own phone and WhatsApp, and a bina.et link with every photo. Use for "used Toyota", "SUV under 10 million birr", "electric car price", "BYD". Not for taxi rides. Source: the BinaSmart car listings at https://bina.et/cars.

read-only

Argument	Type	Description
body	string	Body type
fuel	string	Fuel type
make	string	Brand, e.g. Toyota, Suzuki, BYD, Hyundai, Ford
limit	integer	Max results, default 5
model	string	Model name, e.g. Corolla, Vitz, Dzire, Atto 3
min_year	integer	Oldest model year to include, e.g. 2018
condition	string	New or used
max_price	number	Highest price in birr
cheapest_first	boolean

search_companies

Companies listed on BinaSmart (bina.et/companies): real-estate developers, car sellers, domestic-worker agencies and other employers, with sub-city, website, whether they are hiring on the BinaSmart job board, and their bina.et page (with their homes, cars and vacancies when they have any). Search by name or brand, filter by kind and sub-city.

read-only

Argument	Type	Description
area	string	A sub-city, e.g. Bole, Kirkos
kind	string	Kind of company, e.g. real_estate, car_seller, domestic_agency
limit	integer	Max results, default 10
query	string	Part of a company name or brand
hiring	boolean	Only companies with open jobs on BinaSmart

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "A sub-city, e.g. Bole, Kirkos"
    },
    "kind": {
      "type": "string",
      "maxLength": 30,
      "description": "Kind of company, e.g. real_estate, car_seller, domestic_agency"
    },
    "limit": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Max results, default 10"
    },
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a company name or brand"
    },
    "hiring": {
      "type": "boolean",
      "description": "Only companies with open jobs on BinaSmart"
    }
  },
  "additionalProperties": false
}

search_health

Find hospitals, clinics, dentists, laboratories, health centres and doctors in Addis Ababa from BinaSmart Health (bina.et/health, 250+ places from the city map plus services and doctors the facilities confirmed; doctors' licences are checked by the BinaSmart team). Filter by kind, sub-city, a place to be near (nearest first) and a specialty (children, gynecology, eye, heart, bone, fertility, skin, mental health, blood test). Returns each place's bina.et/health page, landline, sub-city, distance, and its services and doctors when known. Not medical advice; emergencies: 907.

read-only

Argument	Type	Description
area	string	A sub-city: Bole, Kirkos, Arada, Yeka, Lideta, Gulele, Addis Ketema, Kolfe Keranio, Nifas Silk-Lafto, Akaki Kality, Lemi Kura (English or Amharic)
kind	string	lab = laboratory or diagnostic centre; doctor = individual doctors' profiles
near	string	A neighbourhood or landmark to be near, e.g. Piassa, CMC, Megenagna, Edna Mall. Nearest places first.
limit	integer	Max results, default 6
specialty	string	A specialty, service or part of a name, e.g. children, gynecology, eye, blood test, Hayat

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "A sub-city: Bole, Kirkos, Arada, Yeka, Lideta, Gulele, Addis Ketema, Kolfe Keranio, Nifas Silk-Lafto, Akaki Kality, Lemi Kura (English or Amharic)"
    },
    "kind": {
      "enum": [
        "hospital",
        "clinic",
        "dentist",
        "lab",
        "doctor"
      ],
      "type": "string",
      "description": "lab = laboratory or diagnostic centre; doctor = individual doctors' profiles"
    },
    "near": {
      "type": "string",
      "maxLength": 80,
      "description": "A neighbourhood or landmark to be near, e.g. Piassa, CMC, Megenagna, Edna Mall. Nearest places first."
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Max results, default 6"
    },
    "specialty": {
      "type": "string",
      "maxLength": 60,
      "description": "A specialty, service or part of a name, e.g. children, gynecology, eye, blood test, Hayat"
    }
  },
  "additionalProperties": false
}

search_hotels

Hotels, guest houses, pensions, hostels and furnished apartments in Addis Ababa from BinaSmart's directory (1,000+ places from the city map): name, type, sub-city, stars, the hotel's own office phone and website, and its bina.et page. It has no prices or room availability: those come from the hotel, whose phone is included. Not for hospitals or clinics (use search_health) or for shops, restaurants and other buildings (use search_places).

read-only

Argument	Type	Description
area	string	Sub-city or area in English or Amharic, e.g. Bole, Kirkos, Arada, ቦሌ
kind	string	hotel; guest_house (also pensions, ፔንስዮን, መኝታ); hostel; motel; apartment (furnished apartments and suites)
name	string	Part of the hotel name
limit	integer	Max results, default 6
min_stars	integer	Only hotels with at least this many stars (1-5)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "Sub-city or area in English or Amharic, e.g. Bole, Kirkos, Arada, ቦሌ"
    },
    "kind": {
      "enum": [
        "hotel",
        "guest_house",
        "hostel",
        "motel",
        "apartment"
      ],
      "type": "string",
      "description": "hotel; guest_house (also pensions, ፔንስዮን, መኝታ); hostel; motel; apartment (furnished apartments and suites)"
    },
    "name": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of the hotel name"
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Max results, default 6"
    },
    "min_stars": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Only hotels with at least this many stars (1-5)"
    }
  },
  "additionalProperties": false
}

search_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 25 Digital Ethiopia guides, and practical Addis Ababa knowledge (neighbourhoods, transport hubs, Ethiopian time and calendar, emergency numbers). For questions about BinaSmart, Ethiopian paperwork or getting around Addis. Returns the best-matching passages, each with its source url. Exact fares are not in the passages: they come from quote_ride.

read-only

Argument	Type	Description
k	integer	How many passages (default 4)
query*	string	Question or keywords, English or Amharic

Input schema (JSON)

{
  "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_pharmacies

Pharmacies in Addis Ababa from BinaSmart Health (bina.et/health, about 1,700 pharmacies from the Ministry of Health registry and the city map). Search by name or area. With medicine, also returns whether any pharmacy on BinaSmart has reported having that medicine in the last 7 days, and whether it needs a prescription. Not medical advice; emergencies: 907.

read-only

Argument	Type	Description
area	string	A sub-city, e.g. Bole, Kirkos, Arada, Yeka
limit	integer	Max pharmacies, default 8
query	string	Part of a pharmacy name or a neighbourhood word, e.g. Kenema, Red Cross, Megenagna
medicine	string	A medicine name, e.g. paracetamol, amoxicillin, insulin

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "A sub-city, e.g. Bole, Kirkos, Arada, Yeka"
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Max pharmacies, default 8"
    },
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a pharmacy name or a neighbourhood word, e.g. Kenema, Red Cross, Megenagna"
    },
    "medicine": {
      "type": "string",
      "maxLength": 60,
      "description": "A medicine name, e.g. paracetamol, amoxicillin, insulin"
    }
  },
  "additionalProperties": false
}

search_places

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. For hospitals, clinics, dentists, labs and doctors anywhere in Addis Ababa, use search_health. For food (restaurants, cafes, a dish, "lunch near Megenagna") with no listed shop it returns map_place results from the city map: name, area, distance, coords and ride link, with no phone, hours, prices or menu (see map_note).

read-only

Argument	Type	Description
limit	integer	Max results per kind (default 8)
query*	string	Name or part of a name, English or Amharic
category	string	Shop category filter: cafe \| restaurant \| pharmacy \| retail \| service \| gym \| salon \| clinic \| bank \| office \| other

Input schema (JSON)

{
  "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
}

search_properties

Live listings on bina.et/property from Addis Ababa real-estate companies' own websites, checked every week: title, price as the company wrote it (some per m² or in USD), bedrooms, size, area, the listing company with its own phone and WhatsApp, the date the company last updated it, and a bina.et link with every photo. Use for "apartment for rent in Bole", "3 bedroom for sale", "ቤት ኪራይ". Every listing and price is as the company published it.

read-only

Argument	Type	Description
area	string	Neighbourhood in English or Amharic, e.g. Bole, Sarbet, CMC, Ayat, ሳርቤት
beds	integer	At least this many bedrooms (0 = studio)
type	string	Property type
limit	integer	Max results, default 5
query	string	Other words: a building, project or company name
listing	string	Buy (sale) or rent
max_price	number	Highest price in birr (total for sale, per month for rent)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "Neighbourhood in English or Amharic, e.g. Bole, Sarbet, CMC, Ayat, ሳርቤት"
    },
    "beds": {
      "type": "integer",
      "maximum": 10,
      "minimum": 0,
      "description": "At least this many bedrooms (0 = studio)"
    },
    "type": {
      "enum": [
        "Apartment",
        "Condominium",
        "House / Villa",
        "Land",
        "Commercial",
        "Building"
      ],
      "type": "string",
      "description": "Property type"
    },
    "limit": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1,
      "description": "Max results, default 5"
    },
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Other words: a building, project or company name"
    },
    "listing": {
      "enum": [
        "sale",
        "rent"
      ],
      "type": "string",
      "description": "Buy (sale) or rent"
    },
    "max_price": {
      "type": "number",
      "description": "Highest price in birr (total for sale, per month for rent)",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

search_restaurants

Restaurants, cafés and fast-food places in Addis Ababa from BinaSmart Restaurants (bina.et/restaurants, about 890 places from the city map plus what restaurants confirmed). Search by name or cuisine word, filter by kind and sub-city. Returns each place's bina.et page, phone when known, sub-city, cuisine and map point (pass "lat,lng" to quote_ride for a ride there).

read-only

Argument	Type	Description
area	string	A sub-city: Bole, Kirkos, Arada, Yeka, Lideta, Gulele, Addis Ketema, Kolfe Keranio, Nifas Silk-Lafto, Akaki Kality, Lemi Kura
kind	string	Kind of place
limit	integer	Max results, default 10
query	string	Part of a name or a cuisine word, e.g. pizza, burger, habesha, Kaldi's

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "A sub-city: Bole, Kirkos, Arada, Yeka, Lideta, Gulele, Addis Ketema, Kolfe Keranio, Nifas Silk-Lafto, Akaki Kality, Lemi Kura"
    },
    "kind": {
      "enum": [
        "restaurant",
        "cafe",
        "fast_food"
      ],
      "type": "string",
      "description": "Kind of place"
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max results, default 10"
    },
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a name or a cuisine word, e.g. pizza, burger, habesha, Kaldi's"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "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… or +2519…)"
    }
  },
  "additionalProperties": false
}