# 📦 ShelfKeeper MCP Server

**MCP server for Amazon FBA sellers** — inventory tracking, profit calculations, COGS analysis, and tax deduction guidance.

Built by [ARJE Bookkeeping & Tax Services](https://arjebookkeeping.com) • A CPA firm managing 90+ Amazon seller clients.

---

## 🛠️ Tools Included

| Tool | Description |
|------|-------------|
| `calculate_profit` | Calculate net profit for any FBA product after all fees and COGS |
| `check_inventory_health` | Analyze inventory levels and flag slow movers, overstock, and stranded items |
| `breakdown_cogs` | Break down Cost of Goods Sold into components (product, shipping, prep, duties) |
| `find_tax_deductions` | Identify commonly missed tax deductions for Amazon FBA sellers |
| `calculate_reorder_point` | Calculate when to reorder based on lead time and daily sales velocity |
| `get_fba_fee_reference` | Quick reference for current FBA fee structures by category and size tier |

---

## 🚀 Quick Start

### Option 1: Claude Desktop (stdio)

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "shelfkeeper": {
      "command": "node",
      "args": ["/path/to/shelfkeeper-mcp-server/dist/index.js"]
    }
  }
}
```

### Option 2: Remote HTTP (Vercel deployment)

Use the hosted endpoint:

```
https://shelfkeeper-mcp-server.vercel.app/mcp
```

### Option 3: Install via Smithery

```bash
npx @smithery/cli install shelfkeeper --client claude
```

---

## 📦 Installation (Local)

```bash
git clone https://github.com/arnold-commits/shelfkeeper-mcp-server.git
cd shelfkeeper-mcp-server
npm install
npm run build
npm start
```

---

## 💡 Example Prompts

- "Calculate my profit on a product that costs $8 to source, sells for $24.99, with $5.50 in FBA fees"
- "Check the health of my inventory — I have 500 units, selling 8/day"
- "Break down my COGS for a product: $6 unit cost, $1.20 shipping, $0.50 prep, $0.80 duties"
- "What tax deductions am I probably missing as an FBA seller?"
- "When should I reorder if my lead time is 21 days and I sell 12 units/day?"
- "What are the current FBA fees for standard-size items in the Toys category?"

---

## 🏗️ Project Structure

```
shelfkeeper-mcp-server/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── constants.ts          # FBA fee tables, tax categories, thresholds
│   ├── types.ts              # TypeScript interfaces and types
│   ├── tools/
│   │   └── fba-tools.ts      # All 6 tool implementations
│   └── services/
│       └── calculations.ts   # Core business logic and formulas
├── dist/
│   └── index.js              # Compiled output
├── package.json
├── tsconfig.json
├── smithery.json
├── vercel.json
└── README.md
```

---

## 📊 Who This Is For

- **Amazon FBA Sellers** who want AI-powered inventory and profit analysis
- **Bookkeepers** managing multiple Amazon seller clients
- **CPAs** providing advisory services to ecommerce businesses
- **Ecommerce consultants** who need quick FBA calculations

---

## 🤝 About ARJE Bookkeeping & Tax Services

We specialize in bookkeeping, tax preparation, and advisory services for Amazon FBA sellers and ecommerce businesses. With 90+ active clients, we understand the unique challenges of FBA accounting.

🌐 [arjebookkeeping.com](https://arjebookkeeping.com)

---

## 📄 License

MIT License — free to use, modify, and distribute.