Dukkani — Saudi groceries and grocery cashier

io.github.suhaH5Published by GitHub account suhaH5v1.1.0Updated Oct 29, 2026

Find Saudi groceries by city and district, send them a shopping list; free cashier and debt book.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Dukkani lets an assistant find Saudi neighbourhood groceries by city, district or coordinates and prepare a shopping list as a ready-to-send WhatsApp order…

What you can do
  • Find groceries in Saudi Arabia by city, district or coordinates, with distance and order/map links
  • List the Saudi cities covered by the directory, with grocery counts
  • Turn a shopping list into a prepared order for one grocery, returning an order page link with the list already written
  • Provide facts and links about Dukkani for grocery shop owners (cashier, debt book, barcode)
When to use it
Useful when a user in Saudi Arabia asks for a nearby grocery (بقالة / تموينات) in a given city or district, or wants to send a shopping list to one of them. Also handy when a grocery owner asks about a cashier or debt-book app.
Requirements
Remote streamable HTTP endpoint at dukkanlink.com; no package, environment variables or headers declared. The customer needs WhatsApp to actually send the prepared order.
Before you install
The server states it sends nothing itself: the prepared order is only a link the customer reviews and sends on WhatsApp. Directory data may be out of date, and the open field reflects customer confirmations, not opening hours. No authentication is declared.

Installation

In SourceWeft

  1. Open Dukkani — Saudi groceries and grocery cashier 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/io.github.suhaH5%2Fdukkani/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": {
    "dukkani-saudi-groceries-and-grocery-cash": {
      "type": "http",
      "url": "https://dukkanlink.com/mcp"
    }
  }
}

Tools

4

find_groceries

دوّر بقالة قريبة — Find nearby groceries (Saudi Arabia)

Find neighbourhood groceries (بقالات / تموينات) in Saudi Arabia from Dukkani's public directory, by district (حي) + city, by city, or by coordinates. Returns each grocery's name, city, distance (km, when known), an order_url (Dukkani order page; the customer sends the order on WhatsApp), a map_url and open (customers' open/closed confirmations of the last 3 hours, or null), plus nearest_url: the live «nearest grocery» radar for where the user is now. Groceries that use Dukkani and take orders in the app come first (on_dukkani=true). Use the Arabic district/city names when you have them (e.g. district «النهضة», city «عفيف»).

Parameterscitylimitdistrictlatitudelongitude

prepare_grocery_order

جهّز طلب مقاضي — Prepare a shopping-list order

Turn a shopping list into a ready order for one grocery from find_groceries (pass its id, e.g. «d:82» or «b:abc12»). Returns the cleaned list and an order_url: Dukkani's order page with that grocery chosen and the list already written, so the customer only checks it and sends it on WhatsApp. This tool sends nothing by itself.

Parametersnoteitemsrequiredgrocery_idrequired

list_cities

المدن المتوفرة — Cities in the directory

List the Saudi cities that have groceries in Dukkani's directory, with how many. Use it when a city is not found or the user asks where it works.

Takes no parameters.

dukkani_for_shop_owners

دكّاني لصاحب البقالة — Dukkani for grocery owners

Facts about Dukkani for a grocery owner (cashier on the phone, debt book from a photo of the paper book, barcode, worker in his language, orders from neighbourhood customers) and the links to try it. Use when a shop owner asks for a cashier/POS app, a debt book app or how to run a grocery from a phone in Saudi Arabia.

Parameterstopic

Version history

2
  1. v1.1.0LatestOct 29, 2026
  2. v1.0.0Oct 26, 2026

Score

83% 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

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.