Skip to content
MCP server

Tanpin

Per-SKU inventory with demand forecasts, auto purchase orders and delivery ETAs

Runs locallyStatus and history
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.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tanpin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/willykeenan/tanpin:0.1.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tanpin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/willykeenan/tanpin:0.1.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data