# stock-surplus is an inventory management MCP. AI Agent Connect > stock-surplus lets your AI client manage inventory integrity by reconciling available stock against specific demand. It handles everything from checking current quantities to identifying critical shortfalls and earmarking items to prevent over-selling. You can use it to keep your warehouse operations running without the guesswork of manual stock counts. ## Overview - **Category:** inventory-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_lJolmP9L7sAyHejNt9CnQUNPtyuCtcHk6cjcSTvC/ai-agent-connect - **Tags:** stock, inventory, surplus, sku, warehouse ## Description You can use this MCP to bridge the gap between your inventory data and your planning needs. Instead of manually checking spreadsheets, you tell your AI client what you need, and it handles the math. It checks what you actually have on hand, calculates what will be left after a specific order is filled, and flags when you are running dangerously low on a SKU. If you are planning a large shipment, you can use it to earmark specific quantities so you don't accidentally promise the same stock to two different customers. It's built to help you maintain a clear picture of your warehouse health without constant manual oversight. Your agent can act as a real-time inventory auditor, checking for shortfalls and ensuring your stock levels match your actual requirements. ## Tools ### calculate_surplus This tool determines how much inventory remains after a specific requirement is met. It's useful for seeing what's left over after a large order. ### get_stock_level Use this to ask your AI client for the current available quantity of a specific product. It provides immediate visibility into your stock. ### reserve_stock This tool simulates earmarking stock for a specific requirement. It helps you prevent over-committing items that are already spoken for. ### validate_inventory_health This tool checks the entire system to see if any products are currently in a state of shortfall. It's your primary way to spot critical stock issues. ## Prompt Examples **Prompt:** ``` How much stock is available for SKU 'PROD-123'? ``` **Response:** ``` There are 150 units of 'PROD-123' currently available in stock. ``` **Prompt:** ``` Calculate the surplus for SKU 'SKU-99' if I need 50 units. ``` **Response:** ``` After fulfilling the requirement of 50 units for 'SKU-99', there is a surplus of 25 units remaining. ``` **Prompt:** ``` Is the inventory for SKU 'LOW-STOCK-01' healthy? ``` **Response:** ``` No, the inventory for 'LOW-STOCK-01' is in a critical state with a shortfall of 10 units. ``` ## Capabilities ### Real-time stock checks Your agent queries current quantities for any specific SKU. ### Surplus calculation The AI calculates remaining stock after fulfilling specific orders. ### Shortfall detection Your agent identifies products that have fallen below required levels. ### Stock earmarking The AI simulates reserving items to prevent double-selling. ### Inventory health audits Your agent scans the system to find critical inventory gaps. ## Use Cases ### Order Fulfillment Planning Check if you have enough stock to cover a new large order without running out of other items. ### Preventing Over-selling Reserve stock for a specific customer to ensure those items aren't promised elsewhere. ### Routine Health Checks Run a scan to see which SKUs are currently in a shortfall state. ### Stock Level Verification Quickly get the exact quantity of a specific SKU during a conversation with your agent. ## Benefits - Prevents over-commitment by simulating stock reservations. - Identifies critical shortfalls before they become fulfillment issues. - Automates the math involved in calculating remaining stock after orders. - Provides instant visibility into SKU availability. ## How It Works Getting this MCP running is a one-time setup that connects your AI client directly to your inventory data. 1. Subscribe to the stock-surplus MCP on Vinkius. 2. Connect your preferred client like Claude or Cursor with one click. 3. Ask your AI client to check stock levels or calculate surplus. 4. The MCP executes the tool and returns the data to your agent. ## Frequently Asked Questions **How do I connect this MCP to my AI client?** You connect it through the Vinkius dashboard. Once you subscribe, you can add the connection to Claude, Cursor, or Windsurf with a single click. **Can I use this with any AI client?** Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf. **Does this MCP host my data?** Vinkius hosts the MCP and manages the connections, so you don't have to run any local infrastructure. **What happens if I want to reserve stock?** The reserve_stock tool allows your agent to simulate earmarking items, which helps you see if you have enough stock to commit to a specific requirement without over-promising. **How does it identify shortfalls?** The validate_inventory_health tool scans your products to find any that are currently in a state of shortfall. **How can I check if a product is running low on stock?** You can use the `validate_inventory_health` tool to check if a specific SKU is in a critical state due to a shortfall. **What happens if I try to reserve more stock than is available?** The `reserve_stock` tool will return an error if there is insufficient stock to fulfill the requested reservation. **Can I see the exact amount of remaining stock after an order?** Yes, the `calculate_surplus` tool returns the `surplusQuantity` remaining after the required amount is subtracted.