# Shoplazza MCP > Shoplazza MCP Server manages your e-commerce backend through natural language commands. Connect it to your AI agent to programmatically list products, retrieve current inventory levels, pull detailed customer profiles, and track real-time order fulfillment status for cross-border sales. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** retail-orchestration, cross-border-sales, product-metadata, inventory-tracking, api-integration, checkout-optimization ## Description Connect Shoplazza to your AI agent and take full control of your e-commerce backend using plain language commands. You'll programmatically access everything about your store—from managing inventory counts to pulling detailed customer profiles, even tracking cross-border fulfillment status. This server lets you talk directly to your store data through natural conversation. ### **Managing Product Listings** You can start by getting a full overview of what you sell. Use `list_shoplazza_products` to pull a paginated list of all available product IDs and their names in the catalog, giving you the initial scope of your inventory. If you need more detail on specific items, run `get_shoplazza_product` with an ID; that pulls detailed metadata, including every variant and the exact current stock count for anything you sell. Need to add something new? You can punch a brand-new product listing into the catalog using `create_shoplazza_product`. Beyond the basics, you'll always know what collections are running. Use `list_shoplazza_collections` to read every defined group—stuff like 'Summer Sale' or 'New Arrivals.' You also get general store context by calling `get_shoplazza_shop`, which fetches high-level configuration details for the whole environment. ### **Handling Customer Profiles** When you need customer data, you got options. To see who’s in your system, run `list_shoplazza_customers` to get a paginated list of all existing customer IDs and their basic info. If you want the whole story on one person—their purchase history, contact details, everything—use `get_shoplazza_customer`, feeding it a specific customer ID. Need to onboard a new client? You can create an entirely new record using `create_shoplazza_customer` and provide all the necessary details. ### **Tracking Orders and Fulfillment** Monitoring orders is critical, especially when you're doing international sales. Start by calling `list_shoplazza_orders`; this pulls a list of recent order records, giving your agent the key identifiers needed for deep dives. To get the full technical scoop on any single transaction, use `get_shoplazza_order`, providing one specific order number. This doesn't just give you an ID; it gives you the complete metadata and real-time fulfillment status of that order. ### **System Checks** Before you start, you should always check the pipes. Use `check_shoplazza_status` to instantly verify the current API connectivity status for your Shoplazza store account, making sure everything's green before your agent gets going. ## Tools ### create_shoplazza_customer Creates a new customer record within the Shoplazza system using provided details. ### create_shoplazza_product Adds a completely new product listing to the shop's catalog. ### get_shoplazza_customer Retrieves all stored details for a single, specific customer ID. ### get_shoplazza_order Gets the full technical metadata and status for one specified order number. ### get_shoplazza_product Retrieves detailed information, including variants and inventory counts, for a specific product ID. ### get_shoplazza_shop Fetches high-level configuration details about the entire store environment. ### list_shoplazza_collections Lists all defined product collections (e.g., 'Summer Sale' or 'New Arrivals') currently in the shop. ### list_shoplazza_customers Retrieves a paginated list of all customer IDs and basic details in the system. ### list_shoplazza_orders Lists recent order records, providing key identifiers needed for deeper lookups. ### list_shoplazza_products Retrieves a paginated list of all available product IDs and names in the shop's catalog. ### check_shoplazza_status Verifies the current API connectivity status of the Shoplazza store account. ## Prompt Examples **Prompt:** ``` List all products and show their current price. ``` **Response:** ``` I've retrieved your products. You currently have 15 active high-fidelity profiles, including 'Classic T-Shirt' ($25) and 'Denim Jacket' ($85). Would you like to see the detailed inventory metadata for any of them? ``` **Prompt:** ``` Show the last 5 orders and their fulfillment status. ``` **Response:** ``` Retail orchestrated! I've identified 5 recent high-fidelity order profiles, including order #1001 (Fulfilled) and #1002 (Processing). I've retrieved the technical fulfillment metadata for your review. Shall I summarize the sales progress? ``` **Prompt:** ``` Check the available collections for the 'Summer' promotion. ``` **Response:** ``` Collection directory orchestrated! Your store currently has 5 high-fidelity promotion profiles active, including 'Summer Sale' and 'New Arrivals'. Your API connection is healthy. Shall I retrieve the detailed product orchestration metadata for these collections? ``` ## Capabilities ### Manage Product Listings List all products in the catalog or retrieve detailed metadata for a specific SKU. ### Track Order Fulfillment Status Query complete customer orders, accessing technical details and current fulfillment status. ### Access Customer Profiles Get detailed records of individual customers, including their purchase history and contact information. ### Map Store Structure Read the available product collections or retrieve general store configuration settings. ### Handle New Records Create new customer profiles or add brand-new products to the catalog programmatically. ## Use Cases ### A customer calls with an old order number. The Ops Manager needs to know if Order #9001 was shipped. Instead of asking a junior team member to check the dashboard, they ask their agent. The agent runs `get_shoplazza_order` and immediately reports: 'Order #9001 status is Fulfilled; tracking number ABC is ready for dispatch.' Problem solved in seconds. ### Need to update a product listing across regions. A store owner wants to change the description of their best-seller. They don't have access to the backend API, but they ask the agent. The agent uses `get_shoplazza_product` first to grab the current details, then calls `create_shoplazza_product` (overwriting) with the updated text and sends it back. ### Marketing needs a list of all available product types. The marketing team wants to run a campaign on 'Accessories' but doesn't know which collections exist. They ask their agent, who runs `list_shoplazza_collections`. The agent returns the full directory: ['Summer Sale', 'New Arrivals', 'Winter Gear']. Campaign planning starts immediately. ### Onboarding a new high-value client. The sales rep needs to create a profile for a major corporate buyer. Instead of filling out a web form, they tell the agent's chat: 'Create a customer with email X and company Y.' The agent runs `create_shoplazza_customer` in one command. ## Benefits - Product inventory checks are instant. Instead of logging into the admin panel, use `get_shoplazza_product` to get detailed metadata and current stock counts with a single query. - Order status is always up-to-date. You can pull fulfillment data for any order number using `get_shoplazza_order`, giving your agent real-time tracking information instantly. - Customer history powers personalization. Your AI client accesses full records via `get_shoplazza_customer` and analyzes purchase patterns to write personalized follow-up emails. - Site structure is always visible. Use `list_shoplazza_collections` to understand exactly what merchandising groups exist, letting you target marketing efforts precisely. - Avoid manual data entry. Need a new listing? Call `create_shoplazza_product` and let the agent handle the API payload, saving time and preventing errors. ## How It Works The bottom line is that your AI client uses your token to call specific Shoplazza API endpoints, translating conversation into actionable data requests. 1. First, subscribe to this server and retrieve your Access Token and Shop Domain from your Shoplazza dashboard (Settings > API). 2. Next, configure your preferred AI client (Claude, Cursor, etc.) with these credentials. The agent now has the necessary context to communicate with the e-commerce backend. 3. Finally, issue a command using natural language—for example, 'List all products and check inventory for SKU 123'—and the agent executes the required tools. ## Frequently Asked Questions **How do I check if the Shoplazza MCP Server is working right now?** Run `check_shoplazza_status`. This tool verifies your API connection and confirms that the server can talk to your store without hitting any immediate issues. **Can I list all products and their current price using list_shoplazza_products?** No. `list_shoplazza_products` only gives you a basic ID and name listing. To get the real-time pricing and detailed metadata, you must follow up by calling `get_shoplazza_product` for each specific product ID. **What is the best way to handle an existing customer's purchase history?** Use `get_shoplazza_customer`. This tool pulls the complete profile and associated purchase records, allowing your agent to summarize their spending habits for targeted marketing. **Do I need to call list_shoplazza_orders before get_shoplazza_order?** It depends. If you already have the specific order ID, just use `get_shoplazza_order`. If you only know the date range or want a summary of recent activity, first run `list_shoplazza_orders` to find the IDs. **How do I add a new product listing with Shoplazza MCP Server?** Call `create_shoplazza_product`. This tool handles the API request to add the SKU, description, and initial metadata directly into your live catalog. **What kind of shop configuration details can I pull using `get_shoplazza_shop`?** It provides all the store's core metadata and setup information. Your agent uses this to understand global settings, currency configurations, and general environment rules before running specific sales reports. **When I use `get_shoplazza_product`, do I get detailed inventory counts or just basic product info?** No, it provides technical metadata. This includes variant information and current inventory levels, so your agent knows exactly what's available for sale on any specific SKU. **How does `list_shoplazza_collections` help me with store organization?** This tool lists all defined product collections and categories. It gives you the directory structure needed to run reports or focus marketing efforts on specific groupings of items. **How do I find my Shoplazza Access Token?** Log in to your account, navigate to **Settings** > **API Settings**, and create a new high-fidelity **Private App** to obtain your Access Token. **Can I check product inventory via AI?** Yes! The `get_shoplazza_product` tool allows your agent to retrieve high-fidelity inventory metadata for all product variants and stock locations. **How do I list my shop's customers?** Use the `list_shoplazza_customers` tool to retrieve the complete high-fidelity directory of customer profiles along with their unique identifiers for precise orchestration.