Shelfkeeper Server

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

Built by ARJE Bookkeeping & Tax Services • 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:

{
  "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

npx @smithery/cli install shelfkeeper --client claude

---

📦 Installation (Local)

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

---

📄 License

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