Whale

You can run an MCP server to centrally manage your SwagManager data, including inventory, orders, analytics, customers, and more, from Claude Code or Claude Desktop. This server exposes a programmable interface you connect to from your Claude environment, letting you perform common business actions with ease.

How to use

To use this MCP server, you will connect your Claude tools to the provided MCP endpoints or runtime configuration. You can load tools such as analytics, inventory, orders, products, customers, and other capabilities to perform tasks like viewing sales analytics, adjusting stock levels, creating or updating customers, and generating documents. Each tool is designed to work within Claude’s workflow, enabling you to manage store data efficiently from your Claude environment.

How to install

Prerequisites you need before installing this MCP server:

• Node.js (recommended LTS version)
• npm (comes with Node.js)

Install the MCP server globally using npm, then prepare your environment variables before starting.

npm install -g @swagmanager/mcp

Configuration and environment variables

Create a .env file or set these environment variables for the MCP server to connect to your SwagManager instance and set a default store context.

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

Claude Code configuration

If you use Claude Code, add the MCP server configuration to your Claude settings so Claude can launch and manage the MCP server.

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

If you use Claude Desktop, configure the MCP server in your Claude Desktop MCP settings so Claude can launch the server with the proper environment.

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

The MCP server loads tools dynamically to support a wide range of operations. The default set includes a variety of capabilities to manage analytics, inventory, orders, products, customers, locations, communications, and auditing. You can use these tools to perform actions like generating sales analytics, adjusting stock, querying inventory by location, managing purchase orders, and more.

Development

If you plan to develop or contribute to the MCP server, clone the repository, install dependencies, and start the development server.

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

Available tools

analytics

Sales analytics with flexible date ranges to analyze trends and performance.

inventory

Adjust quantities, set stock levels, and transfer inventory between locations.

inventory_query

Query inventory summaries, velocity, and stock by location.

inventory_audit

Start, count, and complete inventory audits.

orders

Find orders, view order details, and manage purchase orders.

purchase_orders

Create, approve, receive, and cancel purchase orders.

transfers

Transfer inventory between store 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 and manage inbox.

alerts

Low stock and pending order alerts.

documents

Generate COAs and documents.

audit_trail

View audit logs.