📦 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 • A CPA firm managing 90+ Amazon seller clients.

🛠️ Tools Included

Related MCP server: keepa-adapter

🚀 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.