CLI (`mo`)

mo is a command-line client over the MerchantOps API. You authenticate once with OAuth 2.0 (PKCE) — a browser sign-in that stores tokens in your OS keychain — and the CLI then rides the same authenticated, organization-scoped API as the dashboard. It holds no database credentials or service secrets.

A packaged install (Homebrew / PyPI) is on the way. For now, install from source as shown below.

Install

# from the repo root, into your virtualenv
pip install -e ./merchantops-sdk -e ./merchantops-cli
mo --help          # or: python -m merchantops_cli --help

Configure

Settings resolve in order: environment variable → ~/.config/merchantops/config.toml → default.

Setting	Env var	Notes
API base URL	`MERCHANTOPS_API_URL`	default `http://localhost:8000` — a local dev API
OAuth issuer	`MERCHANTOPS_OAUTH_ISSUER`	the Stytch Connected Apps authorization server
CLI client id	`MERCHANTOPS_OAUTH_CLIENT_ID`	the CLI’s public OAuth client (PKCE, no secret)
API audience	`MERCHANTOPS_API_AUDIENCE`	the resource identifier the access token is bound to

Use the API base URL your MerchantOps admin gave you for your organization — the same one the API keys examples use as $MERCHANTOPS_API_URL. The audience is an identifier, not necessarily a URL you can open; it has to match exactly what the API is configured to accept, so take it from your admin too.

Environment variables
config.toml

export MERCHANTOPS_API_URL="<your organization's API base URL>"
export MERCHANTOPS_OAUTH_ISSUER="https://<project>.customers.stytch.dev"
export MERCHANTOPS_OAUTH_CLIENT_ID="connected-app-..."
export MERCHANTOPS_API_AUDIENCE="<audience your admin gave you>"

api_url = "<your organization's API base URL>"
oauth_issuer = "https://<project>.customers.stytch.dev"
client_id = "connected-app-..."
audience = "<audience your admin gave you>"

mo auth login      # browser PKCE sign-in; stores tokens in the keychain
mo auth status     # token presence + expiry
mo auth whoami     # identity from the stored token
mo auth logout

Commands

mo products list --limit 20 --brand HOKA
mo products get 1000047719
mo products search "clifton 10"
mo product-types list

All output is JSON — pipe it into jq:

mo products search "clifton 10" | jq '.[].key'

Tokens are keyed by api_url, so if you change the API URL, run mo auth login again.

Get Started

Catalog

Data ingestion

Enrichment

Pricing

Publishing

Jobs & monitoring

Settings & administration

Agents & Tools

Install

Configure

Commands

​Install

​Configure

​Sign in

​Commands

Install

Configure

Sign in

Commands