runwaystock: inventory reorder points from your sales and stock files
[npm] [CI] [MIT license] [MCP Registry]
Know what to reorder, how much to buy, when each product runs out, and how much money is stuck in dead stock. For e-commerce stores, retailers and small businesses that plan inventory in spreadsheets.
Inventory planning software is expensive, and spreadsheet formulas break. runwaystock reads a sales export and a stock count as CSV files, and applies the standard reorder point and safety stock formulas to every SKU. It's an MCP server and a single Go binary, with no account, no API key and no network access.
What you can ask your agent
- "What do I need to reorder this week, and how much?"
- "Which products will run out first?"
- "How much money is tied up in dead stock?"
- "Which products am I overstocked on?"
Install
As a Claude Code plugin, which adds the MCP server and a skill that tells Claude when to use it. You need Node, which runs the server through npx:
For other MCP clients:
Or build the binary with Go 1.27 or newer:
Usage
Without installing anything, run npx runwaystock check sales.csv stock.csv. This example uses the made-up files in examples/:
Set your own assumptions with --lead 21, --cover 45, --window 60 and --service 99. A lead time in the stock file overrides --lead for that SKU. Add --json for machine-readable output.
How it calculates
Daily sales are averaged over calendar days, including days with no sales. Returns reduce demand. Orders round up to any minimum order quantity (MOQ) in the stock file. Service levels of 90, 95 and 99 use z values of 1.28, 1.65 and 2.33.
MCP tools
Both are read-only, and neither can place orders. inventory_check returns SKUs and quantities to the MCP client, so they reach whichever AI model you use. The CLI keeps everything on your machine.
FAQ
How do I calculate a reorder point? Use the formula above, or run npx runwaystock check sales.csv stock.csv to do it for every SKU.
Does it work with Shopify, Amazon or WooCommerce? It reads CSV and recognizes common column names such as Lineitem sku and Lineitem quantity, and you can name others with --sales-columns. It doesn't connect to those platforms, and it hasn't been tested on each one's real exports yet.
How much sales history do I need? At least 28 days, or it warns that figures are rough. It uses the last 90 days by default.
Limits
- It assumes recent sales predict the near future, so it doesn't see seasonality, promotions or growth.
- Sales lost while out of stock look like low demand, which understates what you'd need.
- The safety stock formula assumes fairly regular demand and a fixed lead time, so treat results as a starting point and check before buying.
- It reads CSV only, up to 50 MB, and doesn't handle bundles or unit conversions.
- So far it has been tested on made-up data, not real exports. If yours fails, please open an issue with the column headers, not your data.
Contributing
Contributions are welcome, from people and from people working with AI agents. See CONTRIBUTING.md. Good first issues:
- Add column names from more e-commerce platforms and languages
- Add
--out to write a purchase list to a CSV
- Group the order list by supplier
- Add a seasonality option that compares with the same period last year
- Add a plugin icon
AI disclosure
This project was largely generated with Claude Code and reviewed by its maintainer.
About me
I'm Giulliano Macedo, and I build developer tools at GoTech Solutions. Follow along or get in touch:
If runwaystock saved you from a stockout, a star helps others find it.
MIT licensed.
Built by Giulliano Macedo, GoTech Solutions · LinkedIn · X
