# Shoplazza / 店匠 MCP > Shoplazza / 店匠 connects your AI agent directly to your global e-commerce backend. It lets you manage products, check real-time inventory, track complex orders, and review customer records—all through natural conversation. Stop logging into the admin panel; let your agent handle core retail operations for international brands. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** cross-border-retail, product-listing, store-management, order-tracking, inventory-sync ## Description Shoplazza / 店匠 connects your agent directly to your global e-commerce backend. You don't have to log into the admin panel or click through menus; your AI client handles core retail operations for international brands. This server gives your agent direct access to your store's data, letting you manage products, check stock counts, track complex orders, and review customer records—all just by talking to it. It’s built to run the day-to-day hustle of running a global shop. **Catalog Management and Discovery:** You can get a list of every single product item currently for sale using `list_products`. Need to know how your items are grouped? Use `list_collections` to see all available curated groupings or categories. If you want the full technical rundown on one specific SKU, call `get_product`; this pulls all the metadata and details for that single item. **Stock and Inventory:** Checking if you've got enough stock is critical. The `get_inventory_levels` tool returns the current count of items for a product or a set of products. This gives real-time inventory status, so you always know what you can sell. You don't have to guess; your agent checks the live numbers. **Order Fulfillment and History:** Want to know what happened with an order? Use `list_orders` to pull a quick list of multiple recent order IDs and their summary data, letting you see where everything stands at a glance. To dive deep into one specific transaction, run `get_order`. This retrieves all the detailed information linked to a single order ID, including payment confirmations, shipping details, and fulfillment status. **Customer Records:** When a customer calls or asks about an issue, you need their history. You can pull basic account details for multiple people using `list_customers`, but if you need specific data on one individual, use `get_customer` to retrieve all their profile details. If you want to see what that customer bought before, the same `get_customer` tool provides a list of their past purchases. **Store Operations and Diagnostics:** The server handles more than just sales data. You can check general store health by calling `get_shop_info`, which pulls high-level information about your overall Shoplazza configuration. If you need to verify external connections, use `list_webhooks` to pull a list of all configured webhooks used for system integrations. These tools ensure everything outside the main platform is talking correctly. It's simple: instead of writing API calls or logging into dashboards, you just tell your agent what you need—whether it’s listing product collections via `list_collections`, verifying stock levels with `get_inventory_levels`, pulling a full order status using `get_order`, finding a customer’s purchase history via `get_customer`, or seeing the complete list of available goods through `list_products`. Your agent handles the data retrieval, letting you focus on running the damn business. ## Tools ### get_customer Retrieves specific details about an individual customer profile. ### get_inventory_levels Returns the current stock count for a specified product or set of products. ### get_order Pulls all detailed information associated with a single order ID. ### get_product Gets the full metadata and details for one specific product item. ### get_shop_info Retrieves general, high-level information about the overall Shoplazza store configuration. ### list_collections Lists all available curated product collections or groupings in the shop. ### list_customers Provides a list of customer accounts registered with the Shoplazza platform. ### list_orders Lists multiple recent order IDs and summary data for quick review. ### list_products Returns a list of all products available in the store, including basic metadata. ### list_webhooks Retrieves a list of configured webhooks used for external system integrations. ## Prompt Examples **Prompt:** ``` List all products in my Shoplazza store. ``` **Response:** ``` I've retrieved your Shoplazza products. You have 30 active items, including 'Classic Leather Boots' and 'Waterproof Jacket'. Would you like to see the details or current stock for any of them? ``` **Prompt:** ``` Show me the last 5 orders from my Shoplazza shop. ``` **Response:** ``` I've listed the last 5 orders from Shoplazza. They include recent transactions for 'Silk Scarf' and 'Silver Watch'. Total value for these orders is $450. Would you like to check the shipping status? ``` **Prompt:** ``` Check the inventory level for item ID 'inv-123456'. ``` **Response:** ``` I've retrieved the inventory data for item 'inv-123456'. Current stock level is 15 units. Would you like me to notify you if it falls below a certain threshold? ``` ## Capabilities ### List all available products Retrieves a complete list of items currently listed in the Shoplazza store. ### Check current stock levels Pulls real-time inventory counts for specific product IDs or categories. ### Retrieve detailed order status Gets comprehensive data on a single order, including payment confirmation and shipping details. ### Find customer purchase history Retrieves specific customer profile information and a list of their past purchases. ### Browse product collections Lists available curated groups or categories of products within the store. ## Use Cases ### Auditing a large shipment A logistics coordinator needs to know if 15 specific items were successfully shipped. Instead of manually checking 15 different order IDs, they ask their agent: 'Show me the status for orders O-400 through O-414.' The agent runs `list_orders` first, then calls `get_order` repeatedly to confirm all necessary tracking and payment data is present. ### Investigating a low stock warning An e-commerce manager notices the sales dashboard flagged 'Jacket' as low. They ask their agent: 'Check inventory for Jacket and list any collections it belongs to.' The agent uses `get_inventory_levels` and then `list_collections`, providing both the current stock count and where they need to update product visibility. ### Investigating a repeat customer query A support agent receives a question about past returns. They ask their agent: 'What did this user buy last year?' The agent uses `list_customers` to identify the ID, then calls `get_customer` to retrieve the purchase history, allowing the agent to answer with specific dates and items. ### Reviewing store setup for integration A developer needs to confirm if a new warehouse system can process orders. They ask their agent: 'What webhooks are currently set up?' The agent executes `list_webhooks` and provides the exact endpoints, saving hours of manual configuration checking. ## Benefits - Real-time stock checks: Use `get_inventory_levels` to instantly confirm if an item is available, avoiding sales that result in backorders. This eliminates manual database lookups for current counts. - Full order audit trail: Pull complete records using `get_order` and `list_orders`. You get the payment status, shipping details, and items purchased—all without navigating through multiple checkout pages. - Targeted product data: Need to know if 'Boots' are on sale? Use `get_product` to retrieve specific metadata points like pricing tiers or collection IDs for targeted reporting. - Customer history access: The `get_customer` tool lets you pull up a customer's full profile and purchase history, giving your agent the context needed to answer complex service questions. - Bulk listing management: Use `list_products` and `list_collections` together. You can quickly audit all active items or see which curated groups of products exist in the store. ## How It Works The bottom line is: you talk to your AI client, and it handles all the API calls to get the specific retail data you need. 1. Subscribe to this server and provide your Shoplazza Shop Domain and Admin API Access Token. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the MCP endpoint. 3. Ask a natural language query. Your agent then uses the appropriate tools (`get_order`, `list_products`, etc.) to pull data from Shoplazza. ## Frequently Asked Questions **How do I check stock for a specific item using the get_inventory_levels tool?** You give the agent the product ID, and it runs `get_inventory_levels`. It returns the current available units. This is fast because it only targets one piece of data. **Can I list all my products using the list_products tool?** Yes, running `list_products` gives you a general roster of everything sold in your store. If you need more details—like specific dimensions or weight—you'll have to use `get_product` next. **What is the difference between list_orders and get_order?** `list_orders` provides a summary of many recent orders (IDs, total value). Use `get_order` when you need the deep, specific details for just one single order ID. **How do I find out what collections my products belong to?** You start by calling `list_collections`. This shows all available groupings. Then you can use that collection name when running other product-related queries. **What credentials are needed to use the get_customer tool?** You need your Shoplazza Shop Domain and an Admin API Access Token. These credentials ensure your agent can access protected customer data, keeping your global sales information secure. **If I run into issues with get_order, how does the system handle incomplete or erroneous records?** The tool returns a structured JSON object detailing the specific error or missing field instead of failing. This lets your agent read the discrepancy and prompt you for necessary follow-up actions. **What are the rate limits when using list_orders repeatedly?** The server manages throttling to keep things stable, typically allowing multiple queries per minute. If you exceed this limit, your AI client will receive a clear error code and wait before retrying. **What specific data does the list_webhooks tool provide about my store?** It lists every configured webhook endpoint URL and details the event types it tracks (like 'order created' or 'product updated'). Use this to audit your current system integrations. **How do I find my Shoplazza Access Token?** Log in to the [Shoplazza Partner Platform](https://partners.shoplazza.com/), create an application, and follow the OAuth 2.0 flow to obtain your Admin API Access Token. **What is the 'shop_domain' format?** Your shop domain should be the full URL of your Shoplazza admin instance, typically in the format: `your-store.myshoplazza.com`. **Can I check inventory for specific items?** Yes. Use the `get_inventory_levels` tool. You can optionally provide a comma-separated list of `inventory_item_ids` to retrieve the stock levels for those specific items.