# ApparelMagic MCP

> ApparelMagic connects your AI agent directly to your cloud ERP system. It lets you manage the entire fashion supply chain—from initial product styles and active orders to real-time inventory counts and shipment tracking—all through simple conversation.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** fashion-tech, order-management, plm, supply-chain, manufacturing, retail-operations

## Description

Managing a modern clothing line means juggling multiple systems: one for sales, another for warehouse stock, and a third for design records. This MCP lets your AI client connect all those functions into a single chat interface. You can use natural language to ask about anything related to your apparel business—check the current stock of a specific SKU, find out the status of an order placed last week, or even pull up a customer's buying history for support. It pulls data from everything, letting you manage product lifecycle and fulfillment without leaving your chat window. By connecting through Vinkius, you get immediate access to this tool alongside thousands of others, giving you one place to control complex operations.

## Tools

### get_customer
Retrieves specific profile details for one customer.

### get_order
Gets all transaction data for a single sales order number.

### get_product
Pulls detailed information about a specific item in the catalog.

### get_shipment
Provides tracking and status updates for one shipment ID.

### list_customers
Lists all registered customers within your ApparelMagic account.

### list_inventory
Retrieves a list of current stock levels across various SKUs and styles.

### list_orders
Generates a summary report of recent sales orders placed.

### list_products
Lists all available products or finished apparel styles in the system.

### list_shipments
Provides a list of all active and completed shipments.

### list_styles
Lists every design style created, regardless of if it's currently in stock.

## Prompt Examples

**Prompt:** 
```
List the last 5 sales orders in ApparelMagic.
```

**Response:** 
```
I've retrieved the latest 5 orders. Order #1001 for 'Global Retail' is currently 'Processing', while #1002 for 'Local Boutique' has been 'Shipped'.
```

**Prompt:** 
```
What is the inventory level for SKU 'TSHIRT-BLUE-L'?
```

**Response:** 
```
I checked the inventory for 'TSHIRT-BLUE-L'. There are 150 units on hand, with 120 available for new orders (30 units are already allocated).
```

**Prompt:** 
```
Show the details for customer 'CUST-889'.
```

**Response:** 
```
Customer 'CUST-889' is 'Fashion Forward Inc'. They have a credit limit of $10,000 and their primary contact is Sarah Miller at sarah@fashionforward.com.
```

## Capabilities

### Check real-time stock levels
List inventory counts for any specific product or style in your collection.

### View customer details and history
Access detailed profiles, credit limits, and past purchase records for individual clients.

### Track sales orders
Retrieve specific order details, including quantities and SKUs, or list recent transactions.

### Monitor shipments and fulfillment status
Check the current location or completion status of any recorded shipment.

### Manage product lines and styles
Browse and retrieve records for every style and finished product in your catalog.

## Use Cases

### A customer calls asking about an old purchase.
Instead of having a team member manually check the CRM, your agent first runs `get_customer` to pull up all contact details and then checks `list_orders` to show the full transaction history on the spot.

### A store manager needs an immediate stock count.
The manager doesn't need to log into three different portals. They ask, 'How many blue shirts are available?' The agent immediately queries `list_inventory` and responds with the exact number.

### A brand owner needs a performance snapshot.
The owner asks for last month's sales movement. The agent calls `list_orders` to get a summary, then uses `list_products` to cross-reference which styles sold the best.

### A warehouse worker needs to track an outbound delivery.
The worker doesn't know the tracking number. They ask, 'What was shipped for Order #1002?' The agent uses `get_order` and then follows up with `get_shipment` to give the exact status.

## Benefits

- Stop manually cross-referencing systems. You can check stock levels using `list_inventory` or view product details with `get_product`, all in one conversation flow.
- Never miss a key customer detail again. Quickly pull up full profiles and history by calling `get_customer`, giving your support team instant context on client calls.
- Streamline fulfillment tracking. Instead of navigating separate logistics dashboards, you can check shipment status with `list_shipments` or verify an individual package using `get_shipment`.
- Simplify order visibility. Use `list_orders` to see a quick summary of recent sales and then drill down into specifics by calling `get_order` for full details.
- Get a complete view of your catalog. You can list all products (`list_products`) or browse every design style using `list_styles`, helping you manage the entire product lifecycle efficiently.

## How It Works

The bottom line is you get instant visibility into your entire product supply chain without building custom integrations or running manual reports.

1. Subscribe to this MCP and provide the required ApparelMagic API Token along with your account subdomain.
2. Connect your AI client (Claude, Cursor, Windsurf, etc.) to Vinkius and select this connector.
3. Ask a natural language question, like 'What's the stock for blue t-shirts?' Your agent executes the query against the ERP data.

## Frequently Asked Questions

**How do I check inventory using list_inventory with ApparelMagic?**
You just ask your agent to 'list the current inventory.' It returns all stock levels for you, letting you see exactly what's available across different product styles.

**Can I find customer details using get_customer in ApparelMagic?**
Yes. Provide a customer ID or name to your agent, and it pulls the full profile data, including contact information and credit limits.

**Does list_orders show me everything about sales? (ApparelMagic)**
It shows you a summary of recent orders. If you need the deep dive—like specific SKUs or quantities for one order—you'll use `get_order`.

**How do I see all available product styles? (ApparelMagic)**
Use the tool to 'list all styles.' This gives you a complete overview of every design style, even if it hasn't been ordered yet. You can then use `get_product` for more details.

**What information do I need to provide when setting up access for tools like `list_products`?**
You must supply your ApparelMagic API Token and Account Subdomain. This connection establishes secure, authenticated access across all the MCP tools so your agent can function correctly.

**Are there rate limits if I run repeated checks using `list_shipments`?**
Yes, usage is governed by API rate limits set by ApparelMagic. If you need to check large volumes of shipments, batch your requests or wait a short period between calls.

**What happens if I use `get_customer` with an ID that doesn't exist?**
The tool returns a specific error structure instead of crashing. Your AI client receives clear feedback, telling you exactly why the customer record could not be found.

**How do I check inventory levels for items listed in `list_orders`?**
First, use `list_orders` to get the required SKUs. Then, feed those specific SKUs into the `list_inventory` tool to see real-time stock counts.

**How do I get my ApparelMagic API Token?**
Log in to your ApparelMagic Cloud account, navigate to **Settings > API > Tokens**, and generate a new token. You will also need your account subdomain (e.g., 'yourbrand' in `yourbrand.app.apparelmagic.com`).

**Does the API support real-time inventory updates?**
Yes, the `list_inventory` tool queries ApparelMagic's current stock records, allowing your AI agent to provide accurate availability information based on latest transactions.

**Can I filter orders by their modification date?**
While the current MCP tools provide basic listing, you can ask your AI agent to 'find recent orders' and it will parse the results from ApparelMagic to identify newly created or updated records.