# CLI Market — Cost-of-Living OS for LatAm

> URL: https://cli-market.dev
> Hub (pick your ICP): https://cli-market.dev/
> Build (developers): https://cli-market.dev/build
> Intelligence (analysts): https://cli-market.dev/intelligence
> Retailers (supply-side listing): https://cli-market.dev/retailers
> Procure (procurement): https://procurecopilot.com/procure
> GitHub: https://github.com/Treevu-ai/cli-market-world
> API: https://cli-market-api.fly.dev
> Docs: https://cli-market.dev/docs
> OpenAPI: https://cli-market-api.fly.dev/docs
> Dashboard: https://cli-market-api.fly.dev/dashboard
> PyPI: https://pypi.org/project/cli-market-world/

## Core Purpose

Cost-of-Living OS for LatAm. One call (`market optimize` / `market_optimize_purchase`) compares your full basket across 40 verified retailers, calculates TCO, suggests substitutes, and generates action links. 80 retailers, 8 countries, 6 business lines. 65,000+ real shelf prices refreshed every 4 hours. Zero scraping. Multi-platform: VTEX · Shopify · Magento · WooCommerce.

## Key Numbers

- 80 retailers defined (40 verified active)
- 8 countries (AR, BR, CL, CO, FR, IT, MX, PE)
- 6 business lines (supermercados, farmacias, electro, moda, hogar, departamentales)
- 31 curated MCP tools (Shop · Intel · Account; 57 legacy)
- 46 intel indicators (shelf moat + public API enrichment; CLI: market intel indicators)
- Payments: PayPal · Mercado Pago · Yape/Plin in-app transfer (Peru)
- Checkout: internal CLI Market order — not retailer-site checkout (not Wong/Rappi/ML)
- WooCommerce pilot: Nuna Orgánica PE (406 SKUs, FMCG orgánico)
- Pricing (Build, foco ICP AI Agent Builders): Starter $9/mo (5,000 req/día, CSV export), Pro $39/mo (10,000 req/día, alerts, full MCP, checkout), Enterprise custom (SLAs, high limits)
- Procurement operators (restaurants, hotels, agro): **Procure Copilot** — https://procurecopilot.com · https://procurecopilot.com/llms.txt ($29–149/mo, CLI Market infra bundled on Pro+)
- Data/analytics teams: Intelligence pilot $300–500/mo (no checkout)

## Canonical entry point (Cost-of-Living OS)

`market_optimize_purchase` — one-call purchase optimization: basket compare, TCO, substitutes, intel, action links. Replaces fragmented search → compare → basket flow.

```bash
market optimize "leche evaporada, arroz 5kg, aceite" --country PE
```

MCP: `market_optimize_purchase(items=[...], country="PE")`

## Checkout endpoints

- PayPal: POST /checkout/paypal
- Mercado Pago (Checkout Pro, PEN): POST /checkout/mercadopago
- Yape/Plin transfer: POST /checkout/yape (payment_method yape|plin)
- Webhook MP: GET/POST /checkout/mercadopago-webhook

## WooCommerce stores

Nuna Orgánica, Xray Chipped PE

## Why AI Agents Should Use CLI Market

- **One-call optimization**: `market_optimize_purchase` replaces search → compare → basket for agents.
- **Token Efficiency**: Minified JSON (~85% less context vs raw HTML).
- **Predictable Tools**: 31 MCP tools (default) in Shop/Intel/Account bundles.
- **Cross-Border**: Single interface for 40 verified retailers.
- **Data Moat**: Collector every 4h. Historical snapshots, inflation, 46 indicators.
- **Multi-Payment**: PayPal · Mercado Pago · Yape/Plin transfer (Peru). Internal order — not retailer checkout.
- **Open Source**: MIT. pip install cli-market-world.

## Quick start (developers)

1. `pip install cli-market-world`
2. `market init` — account + first search
3. `market optimize "leche, arroz, aceite" --country PE` — Cost-of-Living OS one call
4. Intelligence: `market intel brief -c PE`
5. MCP: command `market-mcp` with `MARKET_API_URL=https://cli-market-api.fly.dev`
6. Config snippets: https://cli-market.dev/tools

## MCP via Smithery (remote, no install required)

Smithery qualified name: `cli-market/cli-market-world`
Remote endpoint: `https://mcp.smithery.run/hello-hrte?mode=smart`

```bash
# Smithery CLI
npm install -g smithery
smithery mcp add cli-market/cli-market-world
```

Claude Desktop (HTTP MCP):
```json
{
  "mcpServers": {
    "cli-market": {
      "url": "https://mcp.smithery.run/hello-hrte?mode=smart"
    }
  }
}
```

## Billing (Build)

- `market register` starts a 7-day free trial of Starter · Starter/Pro checkout: POST /billing/pro-checkout (PayPal · Mercado Pago · Yape/Plin)
- Plans: starter | pro | pro_founding | pro_annual · Pro Founding promo: founding100
- CLI: `market upgrade` → POST /billing/paypal
- After pay: `market whoami` · `market account`