MCP App Store
by KeenEthics
Dukkani دكّاني icon

Dukkani دكّاني MCP Server for Claude and ChatGPT

By Dukkani

Overview

Dukkani (dukkanlink.com) is a Saudi app for neighbourhood groceries. This connector gives Claude read-only access to Dukkani's public directory of about 3,000 groceries in 70+ Saudi cities, each placed in its district using official district boundaries. What you can do: • Find groceries near you by district and city (e.g. "An Nahdah, Afif") or by city, sorted by distance, with a map link and an order link. • Turn a shopping list into Dukkani's order page with the grocery chosen and the list already written. You review it and send it to the grocery on WhatsApp yourself — the connector never sends anything. • See which cities the directory covers. • Grocery owners can ask about Dukkani itself: a free cashier on the phone, a debt book that reads a photo of the paper book, and orders from neighbourhood customers. No account or sign-in is needed. Grocery phone numbers are never returned, and your conversation is not stored. Works in Arabic and English.

How to connect

  1. Claude: Open the Dukkani دكّاني listing in the Claude connectors directory and choose Connect. Claude listing Dukkani دكّاني exposes 4 tools here.
  2. ChatGPT: Open the Dukkani دكّاني listing in the ChatGPT app directory and choose Connect. ChatGPT listing Dukkani دكّاني exposes 11 tools here.

Tools

fetch

ChatGPT
Retrieve complete document content by ID for detailed analysis and citation. Use this after finding relevant documents with the search tool to get complete information for analysis and proper citation.

generate_report

ChatGPT
Execute a Frappe report. IMPORTANT: Always call report_requirements(report_name) FIRST to get mandatory filters and valid options, then call this tool with explicit filters. Missing filters are auto-defaulted (dates, company) which often returns empty data. Supports Script Reports, Query Reports, and Custom Reports. Report Builder reports are not supported. Large/prepared reports are handled automatically with polling.

get_doctype_info

ChatGPT
Get DocType metadata and field information

get_document

ChatGPT
Retrieve detailed information about a specific Frappe document. Use when users ask for details about a particular record they know the name/ID of.

list_documents

ChatGPT
Search and list Frappe documents with optional filtering. Use this when users want to find records, get lists of documents, or search for data. This is the primary tool for data exploration and discovery.

report_list

ChatGPT
Discover and search available Frappe business reports across all modules. Use this tool to find the appropriate report for business questions before attempting custom data analysis. Returns a list of available reports with descriptions, modules, and types. Available reports include Sales Analytics, Territory Analysis, Customer Reports, P&L Statement, Balance Sheet, Receivables/Payables, Inventory Reports, Item Movement, Stock Valuation, Payroll, Attendance, and Leave Reports. Always search for existing reports first before building custom queries or analysis.

report_requirements

ChatGPT
Get report metadata including required and optional filters, columns, and execution requirements for Script Reports, Query Reports, and Custom Reports. Use this tool before executing reports to understand what filters are mandatory, what exact filter values are valid, and how to structure the report request. This prevents filter errors and helps plan successful report execution. Returns complete report metadata including filter definitions with field types (Link, Select, Date), valid enum options for select fields, column structure, report type, and capabilities. IMPORTANT: Use this FIRST before calling generate_report to understand what exact filter values are needed - Link fields require exact database names (e.g., exact Company name, Customer name), Select fields show valid enum values. Essential when generate_report returns filter errors or when planning complex report execution. NOTE: Report Builder reports are not supported as they are simple DocType list views without business logic.

search_doctype

ChatGPT
Search within a specific DocType

search_documents

ChatGPT
Global search across all accessible documents

dukkani_for_shop_owners

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

find_groceries

Claude
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) and a map_url. 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 «عفيف»).

list_cities

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

prepare_grocery_order

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

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/dukkani"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/dukkani)