# Fizzpa MCP MCP > Fizzpa MCP connects your AI agent directly to your e-commerce fulfillment and warehouse systems. Use it to manage every part of your order lifecycle—from listing all customer orders to generating shipping labels, checking real-time stock levels, or creating a new sale, all through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** fulfillment, logistics, warehouse-management, order-tracking, shipping-automation, digital-menus ## Description Need to handle complex logistics without opening ten different tabs? This MCP gives your AI agent full control over your e-commerce backend. You can manage everything related to sales, inventory, and shipping directly within your chat client. Instead of manually querying spreadsheets or logging into separate warehouse portals, you simply ask your agent to perform the task. It handles order orchestration—retrieving line items, checking statuses, and updating fulfillment records automatically. You can instantly monitor stock across your product catalog or get a fresh batch of shipping labels ready for printing. This gives operations teams real-time visibility into everything happening in the warehouse without leaving their workspace. By connecting this MCP via Vinkius's catalog, you put enterprise-grade operational power directly into conversation. ## Tools ### check_api_health Verifies that the connection between your agent and Fizzpa is active and working correctly. ### create_new_order Adds a brand-new order to the system, requiring customer names and item lists. ### cancel_order Removes or cancels an entire existing order from the system. ### get_shipping_label Generates a printable shipping label and provides the direct URL to download it. ### get_account_profile Retrieves basic authenticated account details for verification purposes. ### get_order_details Pulls all specific information for one single, identified order ID. ### list_inventory_levels Lists the current available stock count for any specified product SKU. ### list_warehouse_locations Displays all defined storage locations within your warehouse facility. ### list_fizzpa_orders Retrieves a filtered list of customer orders, supporting filters by date or status. ### list_catalog_products Lists every single product available in your entire catalog, including variants. ### list_configured_webhooks Shows a list of all active webhooks set up for real-time event tracking. ### update_order_info Modifies specific details on an order that already exists in the system. ## 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 all customer orders List current orders, check specific order details, or update an existing shipment status. ### Control shipping and labels Programmatically generate printable shipping labels for any completed order. ### Monitor inventory across locations Check real-time stock counts and find out exactly where items are stored in the warehouse. ### Handle catalog data Access full details for every product SKU and variant in your entire catalog. ### Create new sales records Manually add a brand-new order to the system, providing customer names and line items. ## Use Cases ### Customer calls needing a delivery update A customer calls asking about Order #456. Instead of manually looking up the order ID, the agent runs `get_order_details` to pull all necessary shipping information and provides an immediate, accurate status update. ### Warehouse staff running low on stock The supervisor needs to know if they can fulfill a bulk order. The agent uses `list_inventory_levels` across the entire catalog, checking multiple SKUs and reporting back which ones are critically low. ### Marketing team adding a new product line A manager needs to add 10 new items. They use `list_catalog_products` first to view the existing structure, then use other tools to ensure all necessary data points are present before listing them. ### Handling a failed delivery and re-shipping The initial shipment failed. The agent uses `cancel_order` on the old record, confirms the needed changes using `update_order_info`, and then generates a new shipping label via `get_shipping_label`. ## Benefits - Stop searching through logs to find an order status. Use `list_fizzpa_orders` and then follow up with `get_order_details` to instantly verify any shipment, saving you minutes per query. - No more physical label printing errors. The agent handles the whole process: it finds the order, and your AI client generates the direct print URL using `get_shipping_label` immediately. - Inventory checks are instant. Instead of walking to the back room, ask about stock levels; the MCP runs `list_inventory_levels` to tell you how many units are available right now. - Managing updates is simple. Need to change an address or flag something? Use `update_order_info` instead of logging into a separate admin panel and clicking through menus. - Catalog oversight means data integrity stays high. The MCP lets you access full SKU details via `list_catalog_products`, ensuring your agents are always working with the right product information. ## How It Works The bottom line is that your AI client becomes your dedicated logistics coordinator, handling complex data queries and actions in one go. 1. First, subscribe to this MCP via Vinkius. You'll need your API Key (Bearer token) from your Fizzpa dashboard. 2. Next, give your AI agent permission to use the tools. Your agent will now route requests through this connector. 3. Finally, ask your agent a question—like 'What are the stock levels for SKU X?'—and it executes the necessary tool calls to get you an immediate answer. ## Frequently Asked Questions **How do I check if Fizzpa is working before starting a task? (check_api_health)** Use `check_api_health` first. It confirms that your AI agent has live connectivity to the Fizzpa system, preventing you from wasting time on tasks that will fail immediately. **Can I list all customer orders and filter them by date? (list_fizzpa_orders)** Yes, `list_fizzpa_orders` supports filtering. You can specify the status or a date range to narrow down exactly which shipments you need to see. **What happens if I try to update an order with wrong information? (update_order_info)** The tool is designed to validate your input. If the parameters are incorrect or the order doesn't exist, it fails gracefully and tells you exactly what data was missing. **Do I need separate tools for inventory and catalog details? (list_inventory_levels & list_catalog_products)** No. While they are distinct tools, the MCP treats them as parts of one system. You can use `list_catalog_products` to see all SKUs, then use `list_inventory_levels` to check stock for specific ones. **How do I verify that my API key is correctly set up using the `get_account_profile` tool?** The tool confirms your authenticated user details. It retrieves core account information, like your store name and primary contact email, ensuring your agent has access to the right data before executing complex tasks. **If I need to manually input a sale, what information do I provide when running `create_new_order`?** You must supply both the customer's name and a detailed list of line items. This allows your agent to accurately build a complete order record in the system for fulfillment. **What formats does the `get_shipping_label` tool generate when I need to print a label?** It generates direct print URLs available in both PDF and Image formats. This means your agent can provide multiple options, letting you download or print the label immediately for shipping. **How do I review which events are currently monitored by listing configured webhooks with `list_configured_webhooks`?** The tool provides a list of all active webhook endpoints. This lets you confirm exactly which system events, like order status changes or inventory updates, trigger external notifications. **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.