BinaSmart

et.binaPublished by bina.etOfficial publisherv1.3.2Updated Oct 24, 2026

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

Overview

AI-generated overview

BinaSmart's public MCP server for Ethiopia: quote and book Addis Ababa rides, and look up jobs, tenders, places, homes, cars, news and government guides.

What you can do
  • Quote fixed ride fares and book, check or cancel a ride in Addis Ababa, including shared BinaPool commute corridors and groups
  • Search Addis places: buildings, hotels and rooms, hospitals and departments, restaurants, pharmacies, companies and health facilities
  • Browse Ethiopian jobs, employers, job fields, tenders and tender categories, plus overseas employment agencies
  • Search properties and cars for sale or rent, and list cinema showtimes, events and films
  • Read news articles, TV and radio listings, TV series, and bilingual Digital Ethiopia government and banking guides
  • Run semantic search over BinaSmart's knowledge base of services, rules and guides
When to use it
Useful when an assistant needs current Ethiopia-specific information or local services: getting around Addis Ababa, finding a job, tender, hotel, clinic, home or car, or walking through Ethiopian paperwork such as Fayda ID, telebirr or a passport.
Requirements
Remote Streamable HTTP endpoint; no sign-in, API key or environment variables are needed. Rides require an Ethiopian phone number for the rider. Network access to the endpoint is required.
Before you install
request_ride sends a real driver and cancel_ride cannot be undone; both are write tools, so confirm details first. Bookings take the rider's Ethiopian phone number, which is masked in logs. Some results link out to bina.et for payment or booking, such as cinema seats or film rentals. Bookings are rate-limited per phone and per caller.

Installation

In SourceWeft

  1. Open BinaSmart in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/et.bina%2Fbinasmart/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "binasmart": {
      "type": "http",
      "url": "https://bina.et/mcp"
    }
  }
}

README

BinaSmart MCP server

[MCP Registry] [License: MIT]

The public Model Context Protocol server for BinaSmart (bina.et), Ethiopia's all-in-one platform. Any MCP-capable assistant (Claude, ChatGPT, Gemini and others) can use it to:

  • Ride in Addis Ababa: quote fixed fares, book a ride (the user confirms first), check its status, cancel it
  • Find places: buildings, hotels, hospitals and clinics, shops and restaurants, with their bina.et pages
  • Jobs and tenders: open vacancies by field or city (Amharic or English), employers, open tenders with deadlines. Vacancies show as job cards in assistants that support MCP Apps
  • Working abroad: licensed Ethiopian overseas employment agencies and their GCC partner offices
  • Homes and cars: properties for sale or rent, cars for sale
  • Guides and news: the bilingual Digital Ethiopia guides (Fayda, passport, telebirr, tax, …) and Amharic news
  • BinaPool: shared commute corridors and groups

Endpoint: https://bina.et/mcp (Streamable HTTP, stateless, no sign-in needed) Registry: et.bina/binasmart on the MCP Registry Docs: GET https://bina.et/mcp · health: https://bina.et/mcp/health

Claude plugin

The plugin/ folder is a Claude plugin: the same MCP server plus five skills that show Claude how to use it for rides, jobs, paperwork, places and tenders. It contains no code, only Markdown skills and one MCP server entry.

Connect

In any client that accepts a remote MCP server, add the URL https://bina.et/mcp. For example, in Claude: Settings → Connectors → Add custom connector.

How it is built

  • mcp-server/server.mjs: the MCP endpoint (Express + @modelcontextprotocol/sdk)
  • mcp-server/tools/: one file per tool group (ride, directory, jobs, health, market, content, guides, knowledge, agencies)
  • mcp-server/widgets/ and mcp-server/lib/widgets.mjs: the job-card page (MCP Apps) served as ui://bina/jobs-v1.html, with the @modelcontextprotocol/ext-apps browser bundle inlined
  • mcp-server/lib/: phone normalisation, an idempotency key so retries never double-book, a per-caller rate limiter, the ride API client
  • api/ and hotels/rules.js: the shared usage meter, API-key check and hotel rules from the main BinaSmart app, which this server imports

The server runs next to the private BinaSmart application and reads its data and settings at runtime (database, ride API on localhost, the .env file). No credentials are in this repository. So this code documents exactly what the public endpoint does, but on its own it will not run against BinaSmart data.

Safety

  • request_ride and cancel_ride are marked as write tools (readOnlyHint: false), so clients ask the user before calling them.
  • The job-card page only reads the tool result: it opens bina.et links through the host and can reach no other site.
  • Reviewers can test request_ride with the reserved number 0900000099: it returns a clearly marked test booking and no driver is sent.
  • Bookings are limited per phone (5 per 10 minutes) and per caller (10 per hour). Retries with the same details within 10 minutes return the same booking instead of a second one.
  • Only Ethiopian phone numbers are accepted for rides. Phone numbers are masked in logs.
  • Privacy: bina.et/privacy · Terms: bina.et/terms · Support: bina.et/support

Standalone (tool definitions only)

node mcp-server/stdio.mjs starts the same tools over stdio without the BinaSmart database or .env, so MCP directories such as Glama can build it in their own container and read the tool definitions. Calls that need live data return an error pointing to https://bina.et/mcp.

Tests

bash
cd mcp-server && npm install && node --test test/*.test.mjs

The tests use reserved test phone numbers only.

Licence

MIT. See LICENSE. © 2026 BinaSmart (Ibrahim Kedir).

Source: README.md at commit bfe2783

Tools

33

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

Parameterspickuprequireddropoffrequired

request_ride

Book a BinaSmart 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.

Parameterstierrequiredpickuprequireddropoffrequiredrider_namerequiredrider_phonerequiredpassenger_namepayment_methodpassenger_phone

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.

Parametersride_idrequiredrider_phonerequired

cancel_ride

Cancel a 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.

Parametersride_idrequiredrider_phonerequired

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

Parameterslimitqueryrequiredcategory

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.

Takes no parameters.

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.

Parameterslimitquery

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

Parametersslugrequired

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

Parametersdateslugrequired

list_overseas_agencies

Licensed Ethiopian overseas employment 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).

Parameterscountry

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.

Parametersslug

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

Parameterskqueryrequired

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.

Parameterslatlng

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.

Parameterslatrequiredlngrequired

list_tenders

Open tenders in Ethiopia

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.

Parameterslimitquerynewestcategoryinclude_closed

get_tender

One tender in full

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.

Parametersslugrequired

list_tender_categories

Tender categories open now

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

Takes no parameters.

list_news

BinaSmart Amharic 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.

Parameterslimitquerycategory

get_news_article

One news article in full

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

Parametersslugrequired

list_jobs

Job vacancies in Ethiopia

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.

Parameterscityfieldlimitqueryinclude_closed

get_job

One vacancy in full

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.

Parametersslugrequired

list_job_fields

Fields of work hiring now

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.

Takes no parameters.

get_employer

A company and its vacancies

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.

Parametersslugrequired

search_properties

Homes, land and shops for sale or rent in Addis Ababa

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.

Parametersareabedstypelimitquerylistingmax_price

search_cars

Cars for sale in Addis Ababa

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.

Parametersbodyfuelmakelimitmodelmin_yearconditionmax_pricecheapest_first

search_hotels

Hotels and guest houses in Addis Ababa

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

Parametersareakindnamelimitmin_stars

search_health

Hospitals, clinics, dentists and doctors in Addis Ababa

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.

Parametersareakindnearlimitspecialty

search_restaurants

Restaurants and cafés in Addis Ababa

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

Parametersareakindlimitquery

search_pharmacies

Pharmacies in Addis Ababa

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.

Parametersarealimitquerymedicine

search_companies

Companies in Ethiopia on BinaSmart

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.

Parametersareakindlimitqueryhiring

list_cinema_showtimes

Cinema showtimes in Addis Ababa

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

Parametersfilmcinema

list_tv_and_radio

Ethiopian TV and radio channels

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.

Parameterskindchannel

list_tv_series

Ethiopian TV series and newest episodes

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.

Parametersquery

Version history

6
  1. v1.3.2LatestOct 11, 2026
  2. v1.3.1Oct 11, 2026
  3. v1.3.0Oct 11, 2026
  4. v1.2.1Oct 5, 2026
  5. v1.1.0Oct 2, 2026
  6. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts