# Craftboxx MCP > Craftboxx connects your AI agent directly to specialized field service management tools. Use natural language commands to manage client orders, check material inventory levels, schedule employee appointments, and get real-time business performance stats—all without leaving your chat window. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** resource-management, scheduling, order-tracking, appointment-booking, craft-business ## Description This MCP lets you run an entire operations center through conversation. Instead of jumping between separate apps for scheduling, materials tracking, and order fulfillment, you talk to the system. You can ask about a specific job's status or check what machines are available right now. Need to create a new service appointment? Just tell your agent who needs it and when. The entire catalog of tools is managed by Vinkius, so whether you’re using Claude, Cursor, or any other compatible client, the functionality is always there. You manage everything from listing all employees to checking material availability—it just happens in chat. ## Tools ### create_order This function allows you to submit and create a new craft service order into your system. ### get_business_stats Retrieve key statistics, giving you an immediate summary of the overall business performance. ### get_order_details Get all specific information tied to one single craft order ID. ### list_appointments View a list of scheduled appointments and field service dates for the team. ### list_customers Retrieve contact information and records for all your clients and partners. ### list_employees Get a list of every employee or team member registered in the system. ### list_materials Check the current inventory count and details for all stored materials and parts. ### list_orders View a comprehensive list of every craft order that has ever been placed in Craftboxx. ### list_vehicles_resources Get details on available company vehicles, machines, and other necessary operational resources. ### list_tasks See the status, both open and closed, for all assigned work tasks. ## Prompt Examples **Prompt:** ``` List all active craft orders for this week. ``` **Response:** ``` I've found 5 active orders for this week, including 'Roof Repair - Main St' and 'Electrical Wiring - Office Block'. Would you like to see the assigned employees for these? ``` **Prompt:** ``` Show me the appointments scheduled for tomorrow. ``` **Response:** ``` Tomorrow you have 3 appointments: 08:00 - Customer Consultation (ID: 123), 11:30 - Site Survey (ID: 124), and 15:00 - Maintenance Check (ID: 125). Should I provide details for any of them? ``` **Prompt:** ``` What is the status of company vehicle 'Sprinter - B-CX 101'? ``` **Response:** ``` The vehicle 'Sprinter - B-CX 101' is currently 'Available' and located at the 'Central Depot'. Its last maintenance was on February 10th. Would you like to assign it to a new order? ``` ## Capabilities ### Manage Orders You can check existing job details, list all open orders, or create a brand new service order instantly. ### Track Resources and Staffing List company employees, track which vehicles and machines are available, and manage material stock levels in one place. ### Handle Appointments and Customers View the schedule for field appointments or pull up contact information for any client or business partner. ### Analyze Business Performance Retrieve high-level statistics across your entire operation, giving you a quick snapshot of company health and task status. ## Use Cases ### The Morning Dispatch A manager needs to send three crews out. Instead of checking the calendar, then running a material report, they ask their agent: 'Show me which employees are free today and if we have enough PVC piping for the North Street job.' The agent checks `list_employees`, cross-references available inventory using `list_materials`, and confirms resource readiness. ### The New Client Inquiry A new business calls with an urgent repair. Instead of writing down notes, the user asks their agent to 'Create a service order for Main St.' The agent uses `create_order`, captures all necessary details, and logs it instantly into the system. ### The Progress Report Management needs an end-of-week summary. They ask their agent to 'Give me a total count of active orders and what our current utilization rate is.' The agent executes `get_business_stats` and summarizes the data in plain text. ### The Scheduling Conflict A technician calls out sick. The manager asks their agent to 'List all appointments scheduled for John today.' The agent uses `list_appointments`, shows the list, and then suggests re-routing those jobs using available staff from `list_employees`. ## Benefits - Stop juggling apps. Instead of checking the CRM for customer details, opening a separate scheduling tool, and then jumping to an inventory sheet, you ask your agent one question and get all three data points. - Immediate performance insight: Getting `get_business_stats` lets you see high-level numbers—like total active orders or revenue totals—without running complex reports in a BI dashboard. - Never forget a resource check. You can run `list_vehicles_resources` and immediately know if the specific machine needed for an appointment is available today, saving dispatch time. - Quick order creation: When a walk-in client needs service, you don't need to navigate complex forms; calling `create_order` handles the initial data capture right from your chat window. - Keep track of people and parts. You can list all employees via `list_employees`, cross-reference them with open tasks using `list_tasks`, and know exactly who is assigned where. ## How It Works The bottom line is that you treat complex operations like a natural conversation with your AI client. 1. Connect the Craftboxx MCP to your preferred AI client. You'll need an API key for authorization. 2. Tell your agent exactly what you need—for example, 'List all open orders in the Northeast region.' 3. The agent runs the necessary function and returns structured data, allowing you to continue conversations based on those results. ## Frequently Asked Questions **How do I find out what materials are needed for a job using list_materials?** Use the agent to check inventory. You can ask, 'Do we have enough copper piping for three orders?' The system checks `list_materials` and tells you if the required quantity is available. **Can I create a new order with create_order?** Yes. Just tell your agent the job details—the client name, the service type, and the location. The tool captures all that data to submit the record instantly. **Is list_appointments better than list_tasks for scheduling?** They serve different purposes. Use `list_appointments` when you need confirmed client visit times. Use `list_tasks` for internal work tracking, like 'installing fixtures'—the actual job steps. **How do I check the status of a single job using get_order_details?** Give your agent the specific order ID and ask to see its details. It pulls up everything: who it belongs to, what was requested, and when it's due. **How do I ensure my agent has the right permissions to use `list_customers`?** You must authenticate with your Craftboxx API key in the Vinkius settings. The MCP uses this token to verify read access rights for all data endpoints, including customer records. Always confirm the key is active before running any tool calls. **What type of information does `get_business_stats` retrieve?** This tool pulls high-level operational metrics, giving you a quick overview of company performance. It summarizes data points like total active orders and resource utilization trends, perfect for end-of-day reports. **When using `list_vehicles_resources`, how do I check if equipment is available?** The tool returns a status field (Available, In Use, Maintenance) for each asset. You filter the results based on this status to confirm which vehicles or machines are free for immediate assignment. **If I need an overview of all job orders, is `list_orders` better than checking details one by one?** `list_orders` gives you a comprehensive list of order IDs and statuses immediately. It's much faster for bulk checks; use that first, then run `get_order_details` on specific items if needed. **How do I get a Craftboxx API Key?** Log in to your Craftboxx account, navigate to **Settings > API**, and you can generate or retrieve your API Key from that section. **Can I assign tasks to employees?** Yes, you can use the create_order tool or list employees to see who is available and manage task distribution through conversational commands. **Does Craftboxx support resource management?** Yes, the integration allows you to list company resources like vehicles and machines, helping you track their allocation to different orders or appointments.