Cogny CLI · E-commerce

    Litium summed up from the shell.

    Pull Litium orders, revenue per week in your base currency, best sellers, stock levels, price lists and customers as JSON — from Bash over the Litium MCP. One back-office service account, then every read is a shell command an agent can schedule. Read-only: nothing is written back to the store.

    # 1. sign up (free for 15 calls) — uses your git email
$ npx @cogny/cli init --agent claude-code

# 2. see every Litium tool
$ cogny tools list

# 3. call any tool from Bash — no MCP wiring
$ cogny tools call mcp__Litium__get_sales_summary --input '{…}'
    ❯ start Cogny Solo — $9/mo@cogny/cli on npm →
    ❯

    cogny --who

    TWO PATHS
    You're a human

    Checking how a Litium store is doing means opening Sales in the back office, filtering orders by date and channel, exporting, and building week-over-week sums in a spreadsheet. get_sales_summary pages through every order server-side and returns totals per day, week or month — split by channel, country and currency — in one call. Connect Litium once in Cogny Solo and let your coding agent — or scheduled reports — do the querying for you.

    ❯ start Solo
    You're an agent

    Self-onboard with one command. The CLI issues a key, wires nothing, and exposes every Litium tool over JSON-RPC. First 15 calls are free.

    $ npx @cogny/cli init --agent claude-code
    ❯

    cogny tools call

    3 EXAMPLES

    Real tool names from the Litium MCP. Send --input JSON, get JSON back.

    mcp__Litium__get_sales_summaryOrders and revenue per ISO week in the base currency, with channel and country splits.
    $ cogny tools call mcp__Litium__get_sales_summary \
  --input '{"start_date":"2026-08-01","end_date":"2026-08-31","group_by":"week"}'
    example response
    {
  "base_currency": "SEK",
  "api_flavor": "v7",
  "orders_scanned": 1412,
  "truncated": false,
  "totals": {
    "orders": 1380,
    "cancelled_orders": 32,
    "revenue_inc_vat": 2148930.5,
    "revenue_ex_vat": 1719144.4,
    "items": 2261,
    "avg_order_value_inc_vat": 1557.2
  },
  "periods": [
    {
      "period": "2026-W31",
      "orders": 214,
      "revenue_inc_vat": 331020,
      "avg_order_value_inc_vat": 1546.8
    },
    {
      "period": "2026-W32",
      "orders": 356,
      "revenue_inc_vat": 552114.5,
      "avg_order_value_inc_vat": 1550.9
    }
  ],
  "by_channel": {
    "Sweden": {
      "orders": 1094,
      "revenue_inc_vat": 1693482
    },
    "Finland": {
      "orders": 286,
      "revenue_inc_vat": 455448.5
    }
  },
  "by_currency": {
    "SEK": {
      "orders": 1094,
      "revenue_inc_vat_native": 1693482,
      "revenue_inc_vat_base": 1693482
    },
    "EUR": {
      "orders": 286,
      "revenue_inc_vat_native": 41404.4,
      "revenue_inc_vat_base": 455448.5
    }
  },
  "by_status": {
    "Completed": 1301,
    "Processing": 79,
    "Cancelled": 32
  }
}
    mcp__Litium__get_top_productsBest-selling articles in a window by revenue, quantity or order count.
    $ cogny tools call mcp__Litium__get_top_products \
  --input '{"start_date":"2026-08-01","end_date":"2026-08-31","by":"revenue","limit":3}'
    example response
    {
  "base_currency": "SEK",
  "ranked_by": "revenue",
  "orders_scanned": 1412,
  "distinct_articles": 812,
  "items": [
    {
      "article_number": "104211-001",
      "description": "Wool coat",
      "quantity": 61,
      "orders": 61,
      "revenue_ex_vat": 146400,
      "revenue_inc_vat": 183000,
      "share_of_revenue": 8.5
    },
    {
      "article_number": "109877-014",
      "description": "Leather boots",
      "quantity": 48,
      "orders": 47,
      "revenue_ex_vat": 95232,
      "revenue_inc_vat": 119040,
      "share_of_revenue": 5.5
    },
    {
      "article_number": "101550-002",
      "description": "Cashmere scarf",
      "quantity": 132,
      "orders": 118,
      "revenue_ex_vat": 79200,
      "revenue_inc_vat": 99000,
      "share_of_revenue": 4.6
    }
  ]
}
    mcp__Litium__list_ordersOrders in a window, filtered by Litium 7 state codes (payment 4 = Paid).
    $ cogny tools call mcp__Litium__list_orders \
  --input '{"start_date":"2026-09-01","end_date":"2026-09-07","payment_state":4,"take":2}'
    example response
    {
  "items": [
    {
      "order_number": "LS118402",
      "order_date": "2026-09-07T14:21:08Z",
      "status": "Processing",
      "payment_status": "Paid",
      "delivery_status": "Init",
      "currency": "SEK",
      "grand_total_inc_vat": 2390,
      "channel": "Sweden",
      "country": "SE",
      "customer": {
        "customer_number": "48211",
        "email": "anna@example.se",
        "city": "Göteborg"
      },
      "row_count": 2
    },
    {
      "order_number": "LS118401",
      "order_date": "2026-09-07T13:58:40Z",
      "status": "Completed",
      "payment_status": "Paid",
      "delivery_status": "Delivered",
      "currency": "EUR",
      "grand_total_inc_vat": 189,
      "channel": "Finland",
      "country": "FI",
      "customer": {
        "customer_number": "31077",
        "email": "mika@example.fi",
        "city": "Helsinki"
      },
      "row_count": 1
    }
  ],
  "count": 2,
  "take": 2,
  "skip": 0,
  "total": 318,
  "has_more": true
}
    ❯

    cogny tools list

    MORE

    A sample of the rest of the Litium surface. Run cogny tools list --json for every tool and its input schema.

    mcp__Litium__get_storemcp__Litium__count_ordersmcp__Litium__get_ordermcp__Litium__search_productsmcp__Litium__get_productmcp__Litium__search_variantsmcp__Litium__get_variantmcp__Litium__list_categoriesmcp__Litium__list_inventoriesmcp__Litium__get_inventory_itemsmcp__Litium__list_price_listsmcp__Litium__get_price_list_itemsmcp__Litium__search_customersmcp__Litium__get_customermcp__Litium__call_admin_api
    ❯

    cogny --faq

    Is this an official Litium CLI?

    No — it is the Cogny CLI calling the Litium MCP over the cogny-mcp-proxy, which speaks Litium’s Admin Web API (docs.litium.dev). You connect a back-office service account once in Cogny, then read the store from Bash. Litium AB is not affiliated.

    Which Litium versions work?

    Litium 7 and Litium 8. The proxy probes the Admin Web API once per store to tell them apart (orders live at /sales/orders on 7 and /sales/salesOrders on 8) and normalizes both order shapes to one record, so the same tools and templates work on either.

    Where do I get the credentials?

    In the Litium back office: Settings → System settings → Service accounts. Create a service account with read permission for Sales, Products, Customers and Globalization, copy its username and password, and enter them in Cogny together with the store URL (the host that serves /Litium/swagger). Service accounts cannot log in to the back office or the storefront.

    Can it modify my store?

    No. Every tool is read-only, and the call_admin_api escape hatch only allows GET and POST to /search and /keyLookups paths. Writes (orders, catalog, prices) are deliberately not exposed in this first release.

    How are multi-currency orders summed?

    get_sales_summary and get_top_products convert each order to the store’s base currency using the currency’s exchange rate (Litium 7: the currency table; Litium 8: the rate stored on the order) and also report native amounts per currency so you can sanity-check the conversion.

    ❯

    related CLIs

    /cli/shopify→/cli/woocommerce→/cli/abicart→/cli/fortnox→/cli/ga4→

    Building an agent? The full tool map for all servers is one fetch: /cli/llms.txt