Workflows

Inventory MCP

Read catalog, fulfillment, or supply inventory through the separate CLI and MCP tools.

Choose a stock source

Source	Use it for	Lookup identity
`catalog`	Wholesale catalog counts and stock tracking status	Exact saved SKU
`fulfillment`	Warehouse product inventory	Exact numeric product ID or Shopify product GID
`supplies`	Accessory and supply inventory	Saved accessory ID

Treat each source independently. A catalog product with tracking disabled has no meaningful counted balance. An empty history confirms the query found no matching audit rows.

Try an offline example

Terminal

finoctl --json doctor
finoctl tools
finoctl --fixture inventory summary --source catalog
finoctl --fixture inventory list --source supplies --limit 10

doctor checks local setup. --fixture returns synthetic data suitable for checking commands and client integration.

Read live inventory

Live inventory access requires your administrator’s approval, configured project paths, and existing Wrangler authentication. The v0.3.0 package uses the Mac Wrangler installation at /opt/homebrew/bin/wrangler for this feature. Run doctor to check config_present and wrangler_present before reading. The wholesale website commands have their own browser approval and work separately in Linux cloud workspaces.

Terminal

finoctl --live inventory resolve "Example" --source catalog
finoctl --live inventory get "$SKU" --source catalog
finoctl --live inventory history "$PRODUCT_ID" --source fulfillment --limit 25

Connect a local MCP client

Configure the client to run finoctl mcp over stdio. For a test, use finoctl --fixture mcp. For authorized production reads, use finoctl --live mcp with the same local project configuration. FINO_ALLOW_PRODUCTION_READS=1 is the equivalent opt-in for a local client process.

The tools are fino_sources, fino_inventory_summary, fino_inventory_list, fino_inventory_get, and fino_inventory_history. Discover the current schemas with finoctl tools. Invoke one tool with structured arguments if you need it from a script.

Terminal

finoctl --fixture tool-call fino_inventory_summary --args '{"source":"catalog"}'