Skip to content

What You Can Ask

The Dotlas MCP exposes a set of read-only tools, grouped below into six families. You do not call them directly. You ask your assistant a question in plain language, and it picks the right tools and threads them together. This page shows what each family covers and gives example questions.

The connected client always shows the current tool list

This page describes what the tools do. Your MCP client displays the live, authoritative list of tools and their parameters the moment you connect. If the two ever differ, trust the client.

How the tools connect

Most questions start by identifying a brand. search_brands returns a brandSlug, the identifier that the menu, pricing, geography, delivery, and feed tools use to look up that brand. You rarely see this. The assistant fetches the slug and passes it along for you.

flowchart LR
    Q[Your question] --> S[search_brands]
    S -->|brandSlug| M[Menu & pricing]
    S -->|brandSlug| G[Geography & outlets]
    S -->|brandSlug| D[Delivery & search]
    S -->|brandSlug| F[Promotions & feeds]

Discovery

Find brands by name or cuisine, see which cuisines a market has, list the markets your organization can access, and pull a single brand's profile (logo, colours, socials, outlet count, virtual-brand ratio).

Tools: search_brands, get_cuisines, get_markets, get_brand_profile

  • "Which markets can I access?"
  • "Find McDonald's in the UAE."
  • "Which brands serve sushi in Dubai?"

Read a brand's menu shape, price levels, and discount coverage, then drill into a section, a single item's weekly price history, its price on each source, and its menu-change timeline.

Tools: get_menu_sections, get_section_menu_items, get_item_price_history, get_item_source_prices, get_item_menu_events

  • "What does Shake Shack's menu look like in Saudi Arabia: sections, price levels, discount coverage?"
  • "Has the price of the classic burger changed over the last three months?"
  • "What does this item cost on each delivery app?"

Geography & outlets

Map a brand's footprint, list the outlets in a city or area (with each outlet's rating and review count), find outlets near a point, discover mapped neighborhoods, read per-outlet popular-times busyness, see Dotlas's computed competitor list for a brand — now with the per-dimension similarity breakdown (price, location, menu, search, size) behind the ranking — and rank the brands whose outlets most densely surround a brand's footprint (the market-radar watch set beyond its named competitors).

Tools: get_brand_outlets, get_nearby_outlets, get_neighbourhoods, get_competitor_suggestions, get_radar_brands, get_popular_times

  • "Where are all of Starbucks' outlets in Dubai?"
  • "Which restaurants are near this outlet?"
  • "Who competes with this brand?"
  • "Which brands cluster around this brand's outlets?"

Delivery & search visibility

See a brand's delivery fees, times, and distances by zone — alongside the competitor average and the brand-vs-competitor deltas — the search terms tracked on delivery apps in a market, how a brand ranks over time for a term in a given neighborhood, and a current-vs-previous snapshot of its search rank and visibility share per term and neighborhood.

Tools: get_delivery_performance, get_distinct_search_queries, get_search_ranking_history, get_search_visibility

  • "What are this brand's delivery fees and times across Dubai?"
  • "Which search terms are tracked on delivery apps in the UAE?"
  • "How does this brand rank for 'burger' in this neighborhood over time?"

Promotions, events & social

Track a brand's promotions and ad campaigns as one timeline (ad-campaign rows now carry the creative — media URLs, caption, CTA type — with an optional per-creative gallery grain), map the competitor offer landscape across the neighborhoods a brand operates in, list the menu items that changed recently, see where a brand opened new outlets, and read its recent social posts and engagement.

Tools: get_promotions_feed, get_offer_landscape, get_menu_event_types, get_items_with_recent_events, get_outlets_feed, get_social_media_feed

  • "What promotions is this brand running?"
  • "Which menu items changed recently?"
  • "Where has this brand opened new outlets this year?"

Reviews & customer sentiment

Read a brand's review volume, sources, and rating snapshot with precomputed topic and highlight enrichment; pull newest-first verbatim reviews filtered by topic, sentiment, or text search; and pulse a set of nearby competitor brands for their aggregate topic sentiment — to see whether rivals share a brand's complaints or win where it loses (aggregate only, never verbatim rival reviews; coverage is Dotlas's analysed brand set).

Tools: get_review_summary, get_brand_reviews, get_competitor_review_pulse

  • "What are customers praising and complaining about for this brand?"
  • "Show me recent reviews mentioning slow service."
  • "Do nearby rivals suffer the same complaints as this brand, or win where it loses?"

What the MCP does not cover

Every figure is competitive intelligence from public delivery-app and web data — never a client's own operational data. The tools do not return ad spend or impressions, order volume, sales, revenue, or basket size, and distances are straight-line, not routed delivery times. Ratings, review counts, and popular-times busyness are public popularity proxies, not demand. For the deeper datasets, see the restaurant catalog or contact us.