Every RetailIntel tool is read-only. Here is what each takes and returns.

The tools

• latest_movesLatest moves in Indian retail

  Read-onlyno side effectsidempotent

  The newest moves, each with the move in one figure, its IST date, brands, a one-sentence read, the original outlet with its link and the retailintel.in page.

  Inputs of latest_moves

  Input	Type	Needed	Meaning
  brand	text	optional	A brand name or slug, e.g. "DMart", "Zepto".
  theme	text	optional	A theme slug, e.g. store-opening, leadership.
  kind	text	optional	stores, deals, people, results, launches, strategy, rules or other.
  days	number	optional	Look back 1 to 30 days (default 7).
  limit	number	optional	How many moves, 1 to 20 (default 10).

• get_signalOne move, in full

  Read-onlyno side effectsidempotentdraws a signal card

  The full read of one move: what happened, why it matters, what to watch next, key facts, the original outlet and link.

  Inputs of get_signal

  Input	Type	Needed	Meaning
  slug	text	required	A move's slug, or its retailintel.in/signal/… URL, from another tool.

• brand_profileOne brand: its last 30 days

  Read-onlyno side effectsidempotentdraws a brand card

  One brand at a glance: moves in the last 30 days against the 30 before by kind, the cities of its store moves, the brands it is reported with and its latest moves with sources.

  Inputs of brand_profile

  Input	Type	Needed	Meaning
  brand	text	required	A brand name or slug, e.g. "Tata Croma", "dmart".

• compare_brandsCompare brands (Competitor Watch)

  Read-onlyno side effectsidempotentdraws a compare card

  Competitors side by side: moves about each brand against the window before, by kind, each brand's latest moves and the biggest difference in one line.

  Inputs of compare_brands

  Input	Type	Needed	Meaning
  brands	list of text	required	Brand names or slugs, e.g. ["Blinkit", "Zepto"].
  days	number	optional	Window: 7, 30 or 90 days (default 7; 30 and 90 need a Pro account).

• daily_briefThis morning's brief

  Read-onlyno side effectsidempotentdraws a brief card

  The morning brief: the day's most widely reported moves, each with why it matters and what to watch.

  Inputs of daily_brief

  Input	Type	Needed	Meaning
  brands	list of text	optional	Narrow to these brands.
  themes	list of text	optional	Narrow to these theme slugs.

• get_expansion_mapWho is opening where (a city or a mall)

  Read-onlyno side effectsidempotent

  Store openings in one Indian city or shopping centre over 180 days: the lead, key numbers, openings by category, brands opening elsewhere but not here, and the latest openings with their reports.

  Inputs of get_expansion_map

  Input	Type	Needed	Meaning
  place	text	required	A city or mall name or slug, or its retailintel.in/city/… or /mall/… URL.

• get_groupOne retail or consumer group, across its businesses

  Read-onlyno side effectsidempotent

  A group at a glance: the verdict on its businesses' newest results, revenue growth by business, key numbers, what moved and what to watch.

  Inputs of get_group

  Input	Type	Needed	Meaning
  group	text	required	A group name or key ("Tata", "reliance"), a brand it owns ("Zudio"), or its retailintel.in/group/… URL.

• get_leadership_movesWho moved: leadership moves in Indian retail

  Read-onlyno side effectsidempotent

  Senior hires, promotions and exits: the last 7 days against the 7 before, the read for the reader's role, the moves that matter, announced moves and the most active companies.

  Inputs of get_leadership_moves

  Input	Type	Needed	Meaning
  company	text	optional	A company name or brand slug.
  sector	text	optional	A sector, e.g. "FMCG", "Fashion", "Beauty & wellness"; an unknown one answers with the list of sectors.
  lens	text	optional	Whose read: brand (default) or supplier.
  limit	number	optional	How many latest moves, 1 to 20 (default 10).

• searchSearch RetailIntel

  Read-onlyno side effectsidempotent

  JSON results (id, title, url, text) for brands, themes and moves matching a name or words; pass an id to fetch.

  Inputs of search

  Input	Type	Needed	Meaning
  query	text	required	A brand name or words, e.g. "Croma", "quick commerce funding".

• fetchFetch one RetailIntel page

  Read-onlyno side effectsidempotent

  The full text of one search result (a move, brand or theme) or of any retailintel.in signal, brand or theme URL, as JSON.

  Inputs of fetch

  Input	Type	Needed	Meaning
  id	text	required	An id from search ("signal:…", "brand:dmart") or a retailintel.in URL.

Permissions and side effects

• Every tool carries readOnlyHint: true, destructiveHint: false, idempotentHint: true and openWorldHint: false.
• The server reads RetailIntel's own record of published reports. It does not fetch other sites on a call, read your files, chat history or memory, or ask for anything beyond the tool's inputs.
• The only thing written is a usage record of the call (below). Nothing is created, changed or deleted in any account.
• No tool asks you to pay, subscribe or accept a fee, and none returns a price. A tool that needs a Pro window or more brands names the plan and links the plans page; it does not change anything.

Access and limits

• No sign-in. https://retailintel.in/mcp works for anyone: 50 lookups a day and 30 a minute for each user. A question usually takes 6 to 13 lookups. Everyone using one assistant without an account also shares a daily pool of 2,000 lookups.
• Sign in for more. https://retailintel.in/mcp/account asks you to sign in with OAuth 2.1 and PKCE (dynamic client registration or client ID metadata; refresh tokens are issued). A free account gets 100 lookups a day, Pro 5,000.
• Keys. A RetailIntel API key (Authorization: Bearer ck_live_… or X-API-Key) gives its account's limits.

Errors and status

• Over a limit: the tool answers with an error result that says which limit (minute or day), when it resets and how to get more. Nothing is retried for you and no partial answer is returned.
• Not found or not allowed: an error result that names the input that did not match (an unknown brand, a window your plan does not include) and what to try.
• Bad input: a JSON-RPC invalid-params error that names the field.
• A dead key or an expired sign-in: HTTP 401 with a JSON-RPC error; an expired sign-in also carries WWW-Authenticate so the client can refresh.
• Replies are application/json; there is no stream to hold open.

What we record

For each call: the tool, the assistant's name, whether it worked, and one-way hashes of the IP address and of the anonymous user id the assistant sends, so the daily limit can be applied. The inputs are not stored, and we never receive your conversation. Usage records are deleted after 90 days; daily-limit counters expire after 24 hours. Who we share data with is listed in privacy; for security or support, contact us.