# Fizzpa MCP > Fizzpa MCP Server handles the full lifecycle of e-commerce logistics. Connect your AI client to manage orders, check inventory, and process shipments directly from natural conversation. You can list all orders, generate shipping labels, update stock levels, and track API connectivity without leaving your chat window. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** fulfillment, logistics, warehouse-management, order-tracking, shipping-automation, digital-menus ## Description You'll use this server to handle everything from order intake to shipping manifests. Your AI client acts like a full-time logistics coordinator, letting you manage Fizzpa's e-commerce workflow right from your chat window. You can list all orders, update stock, and generate shipping labels without ever leaving your agent. **Order Management** * You can list all customer orders, filtering them by status or date range, using `list_fizzpa_orders`. You'll get all the specific details for any single order with `get_order_details`. You'll also use `update_order_info` to change an order's status or update who it's going to. * If you need to start a new order, you'll run `create_new_order`, giving it the customer's name and the list of products. You can cancel an existing order using `cancel_order`. **Inventory & Warehouse Control** * To see what you got in stock, you'll check current levels for specific items using `list_inventory_levels`. You can also list every product available in the whole catalog with `list_catalog_products`. To track down where stuff is physically stored, you'll list all warehouse locations with `list_warehouse_locations`. You'll check product availability at a specific spot using the location data from `list_warehouse_locations`. **Shipping and Fulfillment** * You'll generate a printable shipping label (PDF or Image) for any order ID using `get_shipping_label`. You can modify existing order information with `update_order_info`. **System Auditing & Setup** * You'll get general account data using `get_account_profile`. You can list every webhook you've set up for monitoring with `list_configured_webhooks`. You'll check if the Fizzpa API is online and working with `check_api_health`. ## Tools ### cancel_order Cancels an existing order in the system. ### check_api_health Verifies if the Fizzpa API is currently connected and operational. ### create_new_order Adds a new order to the system; requires customer name and list of products/items. ### get_account_profile Retrieves general authenticated account information. ### get_order_details Gets all specific details for a single, identified order. ### get_shipping_label Generates a printable shipping label for a specified order ID. ### list_catalog_products Lists every product available in the entire catalog. ### list_configured_webhooks Shows all active webhooks set up for the account. ### list_fizzpa_orders Lists all customer orders, allowing filtering by status or date range. ### list_inventory_levels Retrieves the current stock count for specific items. ### list_warehouse_locations Lists all physical storage locations within the warehouse. ### update_order_info Modifies details on an existing order, such as status or recipient information. ## Prompt Examples **Prompt:** ``` List all pending orders in Fizzpa. ``` **Response:** ``` I've retrieved your pending orders. You have 3 shipments awaiting fulfillment, including Order #101 (John Doe) and Order #102. Which one would you like to process first? ``` **Prompt:** ``` Get the shipping label for order ID 'ord_123'. ``` **Response:** ``` Label generated! I've retrieved the print URL for order ord_123. You can download or print it here: [link]. Your warehouse team can now finalize the shipment. ``` **Prompt:** ``` What are the stock levels for SKU 'SHIRT-BLUE-L'? ``` **Response:** ``` Checking inventory... For SKU 'SHIRT-BLUE-L' (ID: prod_789), you currently have 45 units available in the 'Primary Warehouse'. I can also check availability in other locations if needed. ``` ## Capabilities ### Manage Order Statuses List, filter, and update customer orders by status, date, or ID using `list_fizzpa_orders` and `update_order_info`. ### Generate Shipping Materials Create a printable shipping label (PDF or Image) for a specific order ID using `get_shipping_label`. ### Check Real-Time Stock Levels Retrieve current inventory counts for specific SKUs or product categories using `list_inventory_levels`. ### Locate Warehouse Stock List all defined warehouse storage locations and check product availability by location using `list_warehouse_locations`. ### Build New Orders Programmatically add new orders to the system, requiring customer name and specific line items via `create_new_order`. ### Audit Account Data Fetch authenticated account details or list all active webhooks for system monitoring using `get_account_profile` and `list_configured_webhooks`. ## Use Cases ### Need to process a batch of outgoing shipments. The warehouse needs to ship 15 orders. Instead of manually pulling 15 order IDs, the agent runs `list_fizzpa_orders` to pull all 'Ready to Ship' orders. Then, for each order ID, the agent calls `get_shipping_label` to generate the required labels, and the team prints them all at once. ### Customer calls asking about a delayed package. A customer service agent gets the order ID and asks the agent to check the status. The agent runs `get_order_details` and verifies the last update time and fulfillment status, giving the customer a precise, immediate answer without looking up the order in three different systems. ### Inventory discrepancy found on the shelf. The supervisor needs to know if the blue shirts are in the main warehouse or the overflow area. They ask the agent to run `list_inventory_levels` for the SKU, and then use `list_warehouse_locations` to narrow down the exact physical storage spot. ### A client submits an urgent, custom order. Instead of emailing a spreadsheet, the sales team uses the agent to run `create_new_order`, providing the customer's name and the exact line items. The system records the order instantly and updates the necessary inventory counts. ## Benefits - Track order status instantly. Instead of logging into the order dashboard, ask your agent to run `list_fizzpa_orders` to see all pending or completed shipments, filtered by status or date. - Eliminate label printing delays. Running `get_shipping_label` gives you a direct print URL (PDF/Image) for an order, letting your team finalize the shipment immediately. - Know your stock, everywhere. Use `list_inventory_levels` to check stock for a SKU, and then use `list_warehouse_locations` to see exactly which physical spot the inventory is sitting in. - Keep your data current. Running `list_catalog_products` gives you the full list of SKUs and variants, letting you verify product details before creating a new sale with `create_new_order`. - Automate updates. If an order status changes or needs correcting, `update_order_info` lets you modify the details programmatically without using the web UI. - Audit the system. Use `check_api_health` to confirm your connection is solid, and `list_configured_webhooks` to see what event data is flowing out of Fizzpa. ## How It Works The bottom line is, your agent treats your entire fulfillment pipeline like a single conversational flow. 1. Subscribe to the Fizzpa MCP Server and retrieve your API Key. 2. Input a natural language command (e.g., 'List all pending orders for John Doe'). 3. The agent calls the necessary tool (e.g., `list_fizzpa_orders`), and you receive the structured data or confirmation. ## Frequently Asked Questions **How do I list all pending orders using the Fizzpa MCP Server?** Use the `list_fizzpa_orders` tool. This function supports filtering, so you can narrow the list by status (like 'Pending') or by a date range to get exactly the orders you need. **Can I change the status of an order using the Fizzpa MCP Server?** Yes, run `update_order_info`. You need to provide the order ID and the new status. This tool changes the order record directly in the system. **What information does the `list_inventory_levels` tool provide?** It gives you the current stock count for specific items (SKUs). You can specify the item and the warehouse to get an accurate count of available units. **Is the Fizzpa MCP Server useful for new orders?** Yes, use `create_new_order`. You must provide the customer's name and the full list of line items for the system to record the new order correctly. **Do I need to check the API connection first using the Fizzpa MCP Server?** It's smart practice. Use `check_api_health` to confirm that your connection to Fizzpa is active and running before starting any complex workflow. **How do I use the `get_shipping_label` tool to generate a label?** You provide the specific order ID to the tool. It then generates a direct print URL (PDF or image) for the label. This lets your agent finalize the shipment without manual steps. **What happens if I try to modify an order with `update_order_info`?** The tool modifies the specified order fields directly in Fizzpa. You must provide the Order ID and the exact data you want to change. This keeps your fulfillment data accurate. **Does `list_catalog_products` show all product details?** Yes, it lists all SKUs and product variants in your catalog. This gives your agent the complete product data needed to manage inventory and create new orders. **How do I find my Fizzpa API Key?** Log in to your Fizzpa dashboard and navigate to **Account Settings** > **API**. Copy the Bearer token displayed in your integration settings. **Can I print shipping labels directly via the agent?** Yes! The `get_shipping_label` tool provides you with the direct URL to the label's PDF or image file for instant printing. **Does it support real-time inventory checking?** Absolutely. The `list_inventory_levels` tool retrieves current stock counts across all your registered products and SKUs.