@swagmanager/mcp

MCP (Model Context Protocol) server for SwagManager — manage inventory, orders, analytics, customers, and more from Claude Code or Claude Desktop.

Setup

npm install -g @swagmanager/mcp

Environment Variables

Create a .env file or set these environment variables:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
DEFAULT_STORE_ID=your-store-uuid

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "swagmanager": {
      "command": "swagmanager-mcp",
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-key",
        "DEFAULT_STORE_ID": "your-store-uuid"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "swagmanager": {
      "command": "npx",
      "args": ["@swagmanager/mcp"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-key",
        "DEFAULT_STORE_ID": "your-store-uuid"
      }
    }
  }
}

Tools

Tools are loaded dynamically from the ai_tool_registry database table. The default set includes:

Tool	Description
analytics	Sales analytics with flexible date ranges
inventory	Adjust quantities, set stock, transfer between locations
inventory_query	Query inventory summary, velocity, by location
inventory_audit	Start, count, complete inventory audits
orders	Find orders, get details, purchase orders
purchase_orders	Create, approve, receive, cancel purchase orders
transfers	Transfer inventory between locations
products	Find, create, update products and pricing
customers	Find, create, update customers
collections	Manage product collections
suppliers	Find and list suppliers
locations	Find store locations
email	Send emails, manage inbox
alerts	Low stock and pending order alerts
documents	Generate COAs and documents
audit_trail	View audit logs

Development

git clone https://github.com/floradistro/whale-mcp.git
cd whale-mcp
npm install
cp .env.example .env  # fill in your credentials
npm run dev

License

MIT