@whattio/mcp-server 1.0.0

package/build/tools/v1/unit.js

@@ -0,0 +1,67 @@
+export const unitTools = [
+    {
+        name: "v1_check_serial_unit",
+        description: "Check if unit serial is available in system/team",
+        inputSchema: {
+            type: "object",
+            properties: {
+                team: { type: "number", description: "Team ID" },
+                serial: { type: "string", description: "Serial UUID" }
+            },
+            required: ["team", "serial"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/checkserial/${args.team}/${args.serial}`);
+            return response.data;
+        }
+    },
+    {
+        name: "v1_create_unit",
+        description: "Add a new unit to a product",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Product ID" },
+                unit_identifier: { type: "string", description: "Serial UUID" },
+                public: { type: "number" }
+            },
+            required: ["id", "unit_identifier"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/unit', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v1_get_unit",
+        description: "Get information about a specific unit by serial via token auth mode",
+        inputSchema: {
+            type: "object",
+            properties: {
+                serial: { type: "string", description: "Serial UUID" },
+                token: { type: "string", description: "Auth token" }
+            },
+            required: ["serial", "token"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/unit/${args.serial}/${args.token}`);
+            return response.data;
+        }
+    },
+    {
+        name: "v1_delete_unit",
+        description: "Delete a specific product unit by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Unit ID" },
+                token: { type: "string", description: "Auth token" }
+            },
+            required: ["id", "token"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.delete(`/api/unit/${args.id}/${args.token}`);
+            return response.data;
+        }
+    }
+];

package/build/tools/v1/user.js

@@ -0,0 +1,46 @@
+export const userTools = [
+    {
+        name: "v1_generate_token",
+        description: "Generate an auth token",
+        inputSchema: {
+            type: "object",
+            properties: {
+                email: { type: "string" },
+                password: { type: "string" },
+                device_name: { type: "string" }
+            },
+            required: ["email", "password", "device_name"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/sanctum/token', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v1_switch_team",
+        description: "Switch your active team. CRITICAL: Use this tool to change context if you encounter 404 Not Found or 403 Forbidden errors when trying to update/view specific resources.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                team_id: { type: "number" }
+            },
+            required: ["team_id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/set_team', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v1_get_user",
+        description: "Get current authenticated user information",
+        inputSchema: {
+            type: "object",
+            properties: {}
+        },
+        handler: async (_args, apiClient) => {
+            const response = await apiClient.get('/api/user');
+            return response.data;
+        }
+    }
+];

package/build/tools/v2/auth.js

@@ -0,0 +1,75 @@
+export const authTools = [
+    {
+        name: "v2_login",
+        description: "Authenticate user with email and password, returns user data and API token",
+        inputSchema: {
+            type: "object",
+            properties: {
+                email: { type: "string", description: "Email Address" },
+                password: { type: "string", description: "Password" }
+            },
+            required: ["email", "password"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/v2/login', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_register",
+        description: "Create a new user account and generate auth token",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Full Name" },
+                email: { type: "string", description: "Email Address" },
+                password: { type: "string", description: "Password" },
+                password_confirmation: { type: "string", description: "Password Confirmation" }
+            },
+            required: ["name", "email", "password", "password_confirmation"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/v2/register', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_get_user",
+        description: "Retrieve current authenticated user information from V2 api",
+        inputSchema: {
+            type: "object",
+            properties: {}
+        },
+        handler: async (_args, apiClient) => {
+            const response = await apiClient.get('/api/v2/user');
+            return response.data;
+        }
+    },
+    {
+        name: "v2_switch_team",
+        description: "Change the current active team for the authenticated user. CRITICAL: Use this tool to change context if you encounter 404 Not Found or 403 Forbidden errors when trying to update/view specific resources.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                team_id: { type: "number", description: "Team ID to switch to" }
+            },
+            required: ["team_id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/v2/switch-team', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_logout",
+        description: "Revoke current authentication token from V2 api",
+        inputSchema: {
+            type: "object",
+            properties: {}
+        },
+        handler: async (_args, apiClient) => {
+            const response = await apiClient.post('/api/v2/logout');
+            return response.data;
+        }
+    }
+];

package/build/tools/v2/category.js

@@ -0,0 +1,109 @@
+export const categoryTools = [
+    {
+        name: "v2_list_categories",
+        description: "Retrieve a paginated list of all categories belonging to the authenticated user's current team",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: { type: "number", description: "The page number to retrieve" },
+                per_page: { type: "number", description: "Number of items per page" }
+            }
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get('/api/v2/category', { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_create_category",
+        description: "Create a new category, brand, or manufacturer",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                country: { type: "string" },
+                city: { type: "string" },
+                email: { type: "string" },
+                phone: { type: "string" },
+                website: { type: "string" },
+                ai_description: { type: "string" },
+                logo: { type: "string", description: "Base64 encoded image or path to file if supported by client" }
+            },
+            required: ["name", "country", "city", "email"]
+        },
+        handler: async (args, apiClient) => {
+            // Sends args as JSON. If the whatt.io API strictly requires multipart/form-data,
+            // it should be capable of parsing application/json as an alternative.
+            const response = await apiClient.post('/api/v2/category/create', args);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_show_category",
+        description: "Get detailed information about a specific category",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Category ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/v2/category/${args.id}/show`);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_get_category_products",
+        description: "Get products by category",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Category ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/v2/category/${args.id}/products`);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_update_category",
+        description: "Update an existing category's information",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Category ID" },
+                name: { type: "string" },
+                country: { type: "string" },
+                city: { type: "string" },
+                email: { type: "string" },
+                phone: { type: "string" },
+                website: { type: "string" },
+                ai_description: { type: "string" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const { id, ...data } = args;
+            const response = await apiClient.post(`/api/v2/category/${id}/update`, { ...data, _method: 'PUT' });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_delete_category",
+        description: "Permanently delete a category from the system",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Category ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.delete(`/api/v2/category/${args.id}/delete`);
+            return response.data;
+        }
+    }
+];

package/build/tools/v2/device.js

@@ -0,0 +1,97 @@
+export const deviceTools = [
+    {
+        name: "v2_list_devices",
+        description: "Retrieve a paginated list of all IoT devices and printers belonging to the authenticated user's current team",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: { type: "number", description: "The page number to retrieve" },
+                per_page: { type: "number", description: "Number of items per page" }
+            }
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get('/api/v2/device', { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_create_device",
+        description: "Register a new IoT device, workstation, or printer to your team. Each device is assigned a unique API key and setup code.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                location: { type: "string" },
+                mode: { type: "string", description: "Device operation mode" },
+                serial_no: { type: "string", description: "Unique Hardware Serial Number" },
+                ethernet: { type: "boolean" },
+                ip_address: { type: "string" },
+                mac_address: { type: "string" },
+                ssid: { type: "string" },
+                active_product_id: { type: "number" },
+                version_no: { type: "string" }
+            },
+            required: ["name", "location", "mode", "serial_no"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/v2/device/create', null, { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_show_device",
+        description: "Get detailed information about a specific device",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Device ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/v2/device/${args.id}/show`);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_update_device",
+        description: "Update the details of an existing IoT device or printer",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Device ID" },
+                name: { type: "string" },
+                location: { type: "string" },
+                mode: { type: "string" },
+                serial_no: { type: "string" },
+                ethernet: { type: "boolean" },
+                ip_address: { type: "string" },
+                mac_address: { type: "string" },
+                ssid: { type: "string" },
+                active_product_id: { type: "number" },
+                version_no: { type: "string" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const { id, ...data } = args;
+            const response = await apiClient.put(`/api/v2/device/${id}/update`, null, { params: data });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_delete_device",
+        description: "Permanently remove a device from your system",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Device ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.delete(`/api/v2/device/${args.id}/delete`);
+            return response.data;
+        }
+    }
+];

package/build/tools/v2/index.js

@@ -0,0 +1,16 @@
+import { authTools } from './auth.js';
+import { categoryTools } from './category.js';
+import { deviceTools } from './device.js';
+import { materialTools } from './material.js';
+import { partTools } from './part.js';
+import { productTools } from './product.js';
+import { unitTools } from './unit.js';
+export const v2Tools = [
+    ...authTools,
+    ...categoryTools,
+    ...deviceTools,
+    ...materialTools,
+    ...partTools,
+    ...productTools,
+    ...unitTools
+];

package/build/tools/v2/material.js

@@ -0,0 +1,114 @@
+export const materialTools = [
+    {
+        name: "v2_list_materials",
+        description: "Retrieve a paginated list of materials",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: { type: "number", description: "The page number to retrieve" },
+                per_page: { type: "number", description: "Number of items per page" },
+                public: { type: "boolean", description: "If true, returns global public materials instead of team-specific ones" }
+            }
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get('/api/v2/material', { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_create_material",
+        description: "Create a new material",
+        inputSchema: {
+            type: "object",
+            properties: {
+                brand: { type: "string", description: "Brand Name" },
+                name: { type: "string", description: "Material Name" },
+                origin_country: { type: "string", description: "Country of Origin" },
+                code: { type: "string", description: "Material Code" },
+                color_code: { type: "string", description: "Color Code" },
+                resin_id: { type: "number", description: "Resin Identification Code (1-7)" },
+                chem_name: { type: "string", description: "Material Chemical Name" },
+                recycled: { type: "boolean", description: "Contains recycled content" },
+                recycle_info: { type: "string", description: "Recycling instructions or information" },
+                recycle_url: { type: "string", description: "External recycling information URL" },
+                bioderived: { type: "boolean", description: "Is bio-derived material" },
+                bio_derived: { type: "string", description: "Bio-Derived From/Details" },
+                waste_category: { type: "string", description: "Waste Category" },
+                origin_type: { type: "string", description: "Origin Type" },
+                recyclable: { type: "boolean", description: "Is Recyclable" },
+                biodegradable: { type: "boolean", description: "Is biodegradable material" },
+                biodegrade_comment: { type: "string", description: "Biodegradability Comments" },
+                buy_link: { type: "string", description: "Material Buy URL" }
+            },
+            required: ["brand", "name", "origin_country"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/v2/material/create', args);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_show_material",
+        description: "Get detailed information about a specific material",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Material ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/v2/material/${args.id}/show`);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_update_material",
+        description: "Update the details of an existing material",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Material ID" },
+                brand: { type: "string", description: "Brand Name" },
+                name: { type: "string", description: "Material Name" },
+                origin_country: { type: "string", description: "Country of Origin" },
+                code: { type: "string", description: "Material Code" },
+                color_code: { type: "string", description: "Color Code" },
+                resin_id: { type: "number", description: "Resin Identification Code (1-7)" },
+                chem_name: { type: "string", description: "Material Chemical Name" },
+                recycled: { type: "boolean", description: "Contains recycled content" },
+                recycle_info: { type: "string", description: "Recycling instructions or information" },
+                recycle_url: { type: "string", description: "External recycling information URL" },
+                bioderived: { type: "boolean", description: "Is bio-derived material" },
+                bio_derived: { type: "string", description: "Bio-Derived From/Details" },
+                waste_category: { type: "string", description: "Waste Category" },
+                origin_type: { type: "string", description: "Origin Type" },
+                recyclable: { type: "boolean", description: "Is Recyclable" },
+                biodegradable: { type: "boolean", description: "Is biodegradable material" },
+                biodegrade_comment: { type: "string", description: "Biodegradability Comments" },
+                buy_link: { type: "string", description: "Material Buy URL" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const { id, ...data } = args;
+            const response = await apiClient.post(`/api/v2/material/${id}/update`, { ...data, _method: 'PUT' });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_delete_material",
+        description: "Permanently delete a material from the system",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Material ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.delete(`/api/v2/material/${args.id}/delete`);
+            return response.data;
+        }
+    }
+];

package/build/tools/v2/part.js

@@ -0,0 +1,102 @@
+export const partTools = [
+    {
+        name: "v2_list_parts",
+        description: "Retrieve a paginated list of parts. Use this tool automatically whenever the user asks about their whatt.io parts, components, sub-assemblies, or manufacturing pieces.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: { type: "number", description: "The page number to retrieve" },
+                per_page: { type: "number", description: "Number of items per page" },
+                public: { type: "boolean", description: "If true, returns global public parts instead of team-specific ones" }
+            }
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get('/api/v2/part', { params: args });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_create_part",
+        description: "Create a new part",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                part_number: { type: "string" },
+                default_method: { type: "string" },
+                material_id: { type: "number" },
+                amount: { type: "number" },
+                description: { type: "string" },
+                self_print: { type: "boolean" },
+                ai_description: { type: "string" },
+                weight: { type: "number" },
+                version: { type: "number" },
+                is_main: { type: "boolean" },
+                buy_link: { type: "string" }
+            },
+            required: ["name", "part_number", "default_method", "amount"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.post('/api/v2/part/create', args);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_show_part",
+        description: "Get detailed information about a specific part",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Part ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.get(`/api/v2/part/${args.id}/show`);
+            return response.data;
+        }
+    },
+    {
+        name: "v2_update_part",
+        description: "Update the details of an existing part",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Part ID" },
+                name: { type: "string" },
+                part_number: { type: "string" },
+                default_method: { type: "string" },
+                material_id: { type: "number" },
+                amount: { type: "number" },
+                self_print: { type: "boolean" },
+                description: { type: "string" },
+                ai_description: { type: "string" },
+                weight: { type: "number" },
+                version: { type: "number" },
+                is_main: { type: "boolean" },
+                buy_link: { type: "string" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const { id, ...data } = args;
+            const response = await apiClient.post(`/api/v2/part/${id}/update`, { ...data, _method: 'PUT' });
+            return response.data;
+        }
+    },
+    {
+        name: "v2_delete_part",
+        description: "Permanently delete a part from the system",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "Part ID" }
+            },
+            required: ["id"]
+        },
+        handler: async (args, apiClient) => {
+            const response = await apiClient.delete(`/api/v2/part/${args.id}/delete`);
+            return response.data;
+        }
+    }
+];