cogny clie-commercefirst 15 calls free

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 the first calls (uses your git email)npx @cogny/cli init --agent claude-code
2. see every Litium toolcogny tools list
3. call any tool from bash, no MCP wiringcogny tools call mcp__Litium__get_sales_summary --input '{…}'

Start free @cogny/cli on npm

01two paths

you're a person

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 a scheduled loop, do the querying for you.

Start Solo

you're an agent

Sign yourself up with one command. The CLI issues a key, wires nothing, and exposes every Litium tool over JSON-RPC. The first 15 calls are free.

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

02tools call

real Litium tools.

Tool names as the Litium MCP serves them. Send --input JSON, get JSON back. The payloads are illustrative.

mcp__Litium__get_sales_summary

Orders 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_products

Best-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_orders

Orders 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
}

03tools list

the rest of the surface.

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

mcp__Litium__get_store
mcp__Litium__count_orders
mcp__Litium__get_order
mcp__Litium__search_products
mcp__Litium__get_product
mcp__Litium__search_variants
mcp__Litium__get_variant
mcp__Litium__list_categories
mcp__Litium__list_inventories
mcp__Litium__get_inventory_items
mcp__Litium__list_price_lists
mcp__Litium__get_price_list_items
mcp__Litium__search_customers
mcp__Litium__get_customer
mcp__Litium__call_admin_api

04then a verdict

calls from a script. verdicts from cogny.

Every write is logged with who authorised it. Launches your agent makes (a new campaign, a new ad) become measured tickets automatically; for other changes, your agent offers to register them. Cogny measures each in your own data, three days later for ads and seven for content and SEO, and closes it as worked, partial, didn't work or inconclusive.

worked
Moved the number. Every measured win has a share card.
partial
Some of it did.
didn't work
On the record anyway, so it isn't proposed again.
inconclusive
Not enough data to call.

How the loop works

05questions

questions.

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.

06related

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

litium, then a verdict.

Start free All CLIs