
Tanpin
Per-SKU inventory with demand forecasts, auto purchase orders and delivery ETAs
- Pricing
- Open source
- Platforms
- self-hosted, Web, API
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 1 day ago
About Tanpin
Tanpin is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
The design follows tanpin kanri, a Japanese retail practice of treating each item as its own business: a manager forms a hypothesis about tomorrow's demand, orders against it and checks the result against sales. The software encodes that loop. It forecasts each SKU from recent sales, weekday patterns, short-term trend and manager-entered notes about events, weather or promotions, then computes safety stock, a reorder point, economic order quantity, pack size, minimum order quantity and a cap on days of supply.
Purchase orders are grouped by supplier and can be emailed automatically, over SMTP or as .eml files, with a delivery ETA derived from lead time, cut-off hour and delivery windows. Dead and slow-moving items are flagged to delist, and ABC classification marks the few items that drive most revenue.
It is a single Node.js 22 program with no runtime dependencies, with a REST API described in OpenAPI, an stdio MCP server, a background daemon that re-forecasts every 15 minutes by default, a dashboard and SQLite storage. A read-only demo with sample convenience-store data runs on Hugging Face.
Install
Run in a terminal
claude mcp add tanpin -- docker run -i --rm ghcr.io/willykeenan/tanpin:0.1.0Add to claude_desktop_config.json
{
"mcpServers": {
"tanpin": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/willykeenan/tanpin:0.1.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tanpin": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/willykeenan/tanpin:0.1.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tanpin": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/willykeenan/tanpin:0.1.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tanpin": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/willykeenan/tanpin:0.1.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tanpin": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/willykeenan/tanpin:0.1.0"
]
}
}
}What it does
- Per-SKU forecasts
- Combines recent sales, weekday factors, trend and manager hypotheses.
- Automatic reorder
- Calculates safety stock, reorder point, order quantity and pack-size rounding.
- Supplier purchase orders
- Groups orders by supplier and emails them or writes .eml files.
- Delivery ETAs
- Uses lead time, cut-off hours and delivery windows.
- Delist flags
- Marks dead and slow SKUs and classifies items A, B or C.
- Signed webhooks and CSV
- Sends HMAC-signed webhooks and imports or exports products and movements.
- Daemon and dashboard
- Runs scheduled cycles and serves a web interface.
Good for
- Reorder a small store's items without a spreadsheet
- Let an agent check stock and raise purchase orders
- Spot slow-moving products worth delisting
- Estimate when a supplier delivery will arrive
- Feed stock changes to other systems through webhooks
Pricing
Open source
Prices change. Check huggingface.co before you buy.
Tanpin FAQ
What does it need to run?
Node.js 22 or newer; it has no runtime dependencies.
How do I try it?
Run npx github:willykeenan/tanpin serve and click Load demo data, or open the read-only Hugging Face demo.
Where does data live?
In a local SQLite file, with a JSON fallback.
Does it send supplier emails?
Yes over SMTP when configured; otherwise it writes .eml files to an outbox.
Is Tanpin free?
Yes. Tanpin is open source, so you can use and self-host it for free.
How do I add Tanpin to Claude Code?
Run this command in your terminal: claude mcp add tanpin -- docker run -i --rm ghcr.io/willykeenan/tanpin:0.1.0
What are the best alternatives to Tanpin?
The closest alternatives to Tanpin are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and O'So MCP Server for PrestaShop.
Alternatives to Tanpin

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data