Retail Reason client distribution

Retail Reason is a hosted expert service for people who operate on Walmart's supplier and seller platforms: Walmart suppliers, Sam's Club suppliers, Marketplace sellers, and the consultants and agencies who serve them. It answers operational questions about metric definitions, screen paths, thresholds and dispute channels. It checks draft deliverables for pitfalls and returns an as_of verification date with each answer. A dated answer is not a promise that every change is detected immediately.

This repository contains only the thin clients: a plugin for Claude Code and Cowork, a Codex CLI config, and the public capability map. All expertise is delivered by the hosted service over an authenticated MCP connection; a user-bound access key (wadv_live_...) is required for Claude Code and Codex. The current, maintained setup instructions for every supported client live at https://retailreason.com/docs/connect/; this README mirrors them. Keys are bound to one named user and Retail Reason account. Do not share them. Each named user may keep at most two keys active so rotation can overlap; every key expires within 180 days and can be revoked sooner by the user or an account owner/admin.

Retail Reason is an independent product. It is not affiliated with, endorsed by, or a product of Walmart Inc.; "Walmart" and the platform names below are used only to describe who the service is for and what it covers.

Install: Claude Code

1. Add the marketplace:

   /plugin marketplace add https://github.com/RetailReason/retail-reason-plugins
   

2. Install the plugin:

   /plugin install retail-reason@retail-reason
   

   (retail-reason is both the plugin and the marketplace identifier. Installs made before September 6, 2026 used walmart-advisor@walmart-advisory; remove that marketplace with /plugin marketplace remove walmart-advisory, then add and install as above.)

3. When prompted, enter a Retail Reason access key (wadv_live_...) created in your Retail Reason account at https://app.retailreason.com/app/access. An eligible account with active access is required; this repository cannot issue a key. The service address is included in the plugin, so no server address needs to be entered.

4. Restart Claude Code and ask any Walmart supplier/seller question to confirm it works.

If the key stops working after a restart: the key is stored in your OS keychain and can occasionally drop. Re-enter it in the plugin's settings (/plugin → Retail Reason → configure). If it keeps happening, use the env-var fallback: set export WADV_LICENSE_KEY="wadv_live_..." in your shell profile and edit the installed plugin's .mcp.json to read "Authorization": "Bearer ${WADV_LICENSE_KEY}". Claude Code expands environment variables in MCP headers.

Install: Claude Cowork

1. In Claude, open Customize → Plugins → Add → Add marketplace and choose Add from a repository. Select RetailReason/retail-reason-plugins or enter https://github.com/RetailReason/retail-reason-plugins, then sync the marketplace.
2. Add Retail Reason and open its Connectors tab. Choose Connect for retail-reason. The server address is https://mcp.retailreason.com/mcp.
3. Use Sign in now and Use Claude's published identity. Add the connector, then choose Connect if sign-in has not opened. Sign in with the same identity that owns your active Retail Reason membership.
4. Start a new Cowork task and ask a supplier or seller question using Retail Reason. Confirm that a Retail Reason tool returns the answer and its as_of verification date.

Cowork uses account sign-in. Do not enter a Claude Code access key as a request header or in chat. If authorization fails, share the displayed support reference with matt@retailreason.com. The plugin's Skills tab should list both setup and walmart-advisor.

Install: Codex CLI

See [`codex/READ

... View full README on GitHub