# @swagmanager/mcp
MCP (Model Context Protocol) server for SwagManager — manage inventory, orders, analytics, customers, and more from Claude Code or Claude Desktop.
## Setup
```bash
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`:
```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:
```json
{
"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
```bash
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
