okala

Unofficial read-only Okala: grocery stores that deliver to you, compare prices across stores. Use when the user asks about Okala (okala.com) or wants food or groceries delivered in Iran.

SKILL.md

GitHub

Okala

Unofficial read-only Okala: grocery stores that deliver to you, compare prices across stores.

The tools below come from the okala-mcp MCP server. If they are not available, install it with claude mcp add okala -- uvx okala-mcp, or add "okala": {"command": "uvx", "args": ["okala-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • ok_login: Log in to the user's Okala account, which unlocks Okala's real text search in ok_search
  • ok_login_verify: Finish a login started with ok_login: the code the user received by SMS. Saves the login on this
  • ok_account: Whether the server is logged in to Okala (and as which phone, masked). Logged in = ok_search uses
  • ok_logout: Delete the saved Okala login on this machine; the server continues as a guest.
  • ok_categories: Category tree (id, slug, Persian name, children) of everything sold near a point, or in one store.
  • ok_search: Find products by text near a point (or in one store with store_id), best matches first, then
  • ok_compare: Which open nearby store sells the same product cheapest: a category and/or brand from every store,
  • ok_store_products: A whole category of one store (the API returns all of it at once), sorted and optionally filtered by
  • ok_product: One product in one store: price and discount (Toman), stock, max per order, brand, category,
  • ok_brands: Brand ids for ok_compare (brand_id) and slugs. Okala publishes only a short list of featured brands;
  • ok_deals: Deal rows running now, with their end time (UTC) and top products (Toman, discount, store).
  • ok_offer: Every product of one deal row (from ok_deals), Toman. Without store_id: across all open stores that
  • ok_locate: Turn an address into coordinates (lat, lon) for every other tool, plus the street address of the best hit.
  • ok_stores: Okala stores that deliver to a point, in the site's order: id, type, rating, distance, earliest
  • ok_store: One store as seen from the delivery point: whether it delivers there now, minimum order (Toman),
  • ok_store_reviews: Read customers' reviews of a store: 1-5 stars, comment, date and the reasons they ticked

Rules

  • Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
  • Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
  • Keep request rates low. These are undocumented site APIs that can change or rate-limit.
  • On timeouts or HTTP 403 outside Iran, set OKALA_MCP_PROXY to an HTTP proxy with an Iranian IP.
  • One exception to no login: real text search needs the optional SMS login (ok_login), which stays read-only. Ask the user before starting it.