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, and list the markets your organization can access.

Tools: search_brands, get_cuisines, get_markets

  • "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, find outlets near a point, discover mapped neighborhoods, and see Dotlas's computed competitor list for a brand.

Tools: get_brand_outlets, get_nearby_outlets, get_neighbourhoods, get_competitor_suggestions

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

Delivery & search visibility

See a brand's delivery fees, times, and distances by zone, the search terms tracked on delivery apps in a market, and how a brand ranks over time for a term in a given neighborhood.

Tools: get_delivery_performance, get_distinct_search_queries, get_search_ranking_history

  • "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, 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_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?"

What the MCP does not cover yet

The tools answer questions about brands, menus, pricing, delivery, geography, promotions, and social activity. They do not return reviews, ratings, or sentiment, even where a review platform appears as a coverage source. For those datasets, see the restaurant catalog or contact us.