# Fixably MCP > Fixably connects your service center operations to any agent, automating the entire repair workflow from start to finish. It lets you manage orders, look up customer history, and track real-time stock levels across multiple locations using natural conversation. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** repair-management, service-center, order-tracking, lifecycle-management, inventory-control, dispatch-automation ## Description Running a service operation means juggling three different systems: inventory, customer records, and job tickets. This MCP handles all of that complexity so your agent doesn't have to. You can talk to it like you’re talking to the dispatch desk. Need to know what parts are available? Just ask. Want to update a client's address *and* change their repair status in one go? No problem. It keeps track of everything—from initial order creation right through to final device location updates. Connecting this MCP via Vinkius means your agent gets access to the whole catalog, so you don't have to worry about connecting twelve separate services. You just manage the repairs with conversation. ## Tools ### add_order_note Adds a specific note or status update to any existing repair order ticket. ### change_internal_location Updates the physical location of a device within the service center's tracking system (e.g., from 'SERVICE' to 'STORE'). ### create_order Initializes and creates an entirely new repair order record in the system. ### get_customer Retrieves all detailed information for a specific customer account. ### get_order Pulls up every piece of metadata and status detail associated with one particular repair order number. ### get_stock Checks the current availability count for specific parts at a given inventory site. ### list_customers Provides a list of all customer accounts registered in the system. ### list_order_files Retrieves a manifest of all files, receipts, or documents linked to a specific order ticket. ### list_orders Generates a list view of multiple repair orders based on status or date range. ### list_stock_products Shows all types of products that the center stocks, regardless of whether they are currently in inventory. ### list_stocks Lists every physical location (inventory site) where stock is held across your network. ### update_order Makes broad changes to an order, such as changing its assigned status or updating key details. ## Prompt Examples **Prompt:** ``` List all active repair orders in Fixably. ``` **Response:** ``` Fetching orders... I found 5 active repair orders, including 'Order #123' for an iPhone 13 and 'Order #456' for a MacBook Pro. Would you like the details for any of these? ``` **Prompt:** ``` Add a note to order '123': 'Diagnostic complete, waiting for replacement screen'. ``` **Response:** ``` Note added! Your update has been successfully posted to order '123'. Technicians and support staff will see this diagnostics update immediately. ``` **Prompt:** ``` Check the available stock at inventory location 'stock_abc'. ``` **Response:** ``` Checking inventory... At location 'stock_abc', you have several parts in stock, including 10 'LCD Assemblies' and 5 'Battery Modules'. Would you like the full product list? ``` ## Capabilities ### Manage full order lifecycles Create new repair orders and update existing ones instantly through conversational commands. ### Lookup customer history Pull detailed client profiles or search for accounts using just a name or email address. ### Inventory and stock checks List all product types available in the warehouse, check current stock levels at specific sites, or list what locations you have set up. ### Update physical device status Change a device's internal location—for example, moving it from 'Service' to 'Store'—or post detailed notes to the job ticket. ### Access attachments and details Retrieve specific order metadata or list all files attached to a repair record for review. ## Use Cases ### The Missing Part Dilemma A technician needs to finish a repair but can't find the necessary component. They ask their agent to check stock at location 'Store A'. The agent uses `get_stock` and reports that 12 units of the specific part are available, allowing the tech to immediately update the order status using `update_order` and complete the job without calling inventory manually. ### Handling Customer Inquiries A support agent gets a call from an upset customer who doesn't know their ticket number. The agent asks their agent to list all orders for that client using `list_orders` and filters down the results. They then use `get_order` to find the specific status, giving the customer an immediate answer. ### The Location Transfer A store manager finishes repairs on a device and needs to move it from the 'Service' area back to the main 'Store' floor. They simply instruct their agent to change the location using `change_internal_location`, which instantly updates the central record. ### Starting a New Job A sales team member takes a walk-in client and needs to start a repair job. They ask the agent to create a new ticket using `create_order`. The agent prompts for necessary details, ensuring all metadata is captured right away. ## Benefits - Saves time on context switching. Instead of opening the customer portal, then the inventory site, and then the order management dashboard, you ask your agent to do it all in one chat session. - Maintains data accuracy by centralizing updates. You can update a device's location using `change_internal_location` while simultaneously adding technical notes via `add_order_note`, ensuring both records are current. - Reduces search friction. If you only have the customer’s name, your agent uses `get_customer` to pull their history and order details without needing an ID number first. - Improves planning by tracking parts. Need to know if a specific screen is in stock? You can use `get_stock` right away, then immediately proceed to `create_order` if the count looks good. - Provides a full audit trail. By using `list_order_files`, you instantly pull up all associated documentation, keeping your workflow clean and traceable. ## How It Works The bottom line is: your agent handles the API calls so you just talk to it naturally. 1. First, subscribe to this MCP through the Vinkius Marketplace. This gives your agent the necessary access keys. 2. Next, input your specific Fixably Subdomain and API Token into your agent's settings. You find these in User Settings > Integrations. 3. After connecting, you can start managing everything—creating orders, checking stock, adding notes—directly through any MCP-compatible client. ## Frequently Asked Questions **How do I use the `get_order` tool with Fixably MCP?** You must provide a unique identifier for the order (like an order number or ticket ID). The agent uses this to pull all associated metadata, allowing you to see everything from initial diagnosis notes to current status. **Can I use `list_customers` and then `get_customer`?** Yes. You can first run `list_customers` to get a general idea of who's in the system, and then use `get_customer` with a specific name or email if you need deep details on one account. **Does Fixably MCP handle inventory updates?** Yes. It supports both listing all available sites using `list_stocks`, and checking the count of products at those sites with `get_stock`. **What's the difference between `create_order` and `update_order`?** `create_order` starts a brand new record from scratch. Use `update_order` when the job already exists, but its status or details have changed. **What credentials do I need to successfully run the `list_orders` tool?** You'll need your Fixably Subdomain and an API Token. You find these in User Settings under Integrations. This setup ensures your AI client has permission to read all required order data. **When using the `get_order` tool, how does the MCP handle non-existent order IDs?** The MCP reports a clear error message indicating that the specified order ID was not found. Your agent can then prompt you to check your input or run `list_orders` for valid alternatives. **If I need to review supporting documents, how does the `list_order_files` tool work?** It returns a list of attached file names and types linked directly to that repair order. You can then pass those filenames to your agent for detailed content retrieval or viewing. **Does the MCP support checking product availability across multiple storage locations using `list_stocks`?** Yes, your agent first runs `list_stocks` to see all available sites. You then pass those location IDs to `get_stock` to check inventory at every specified point. **How do I change the internal location of a device using the agent?** You can use the 'change_internal_location' tool. Simply provide the Order ID and the new location string (e.g., 'SERVICE', 'STORE', or 'CUSTOMER'). The agent will update the record in Fixably immediately. **Can I see which products are available at a specific stock location?** Yes! Use the 'list_stock_products' tool and provide the Stock ID. The agent will return a list of all products currently held at that specific inventory location. **How do I add an internal update to a repair order?** Use the 'add_order_note' tool. You'll need the Order ID and the text of your note. This allows you to document repair progress or internal findings directly from your chat interface.