@whattio/mcp-server 1.0.0

package/src/tools/v1/material.ts

@@ -0,0 +1,81 @@
+import { McpTool } from '../types.js';
+
+export const materialTools: McpTool[] = [
+  {
+    name: "v1_list_materials",
+    description: "Show all materials within a team",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    handler: async (_args, apiClient) => {
+      const response = await apiClient.get('/api/materials');
+      return response.data;
+    }
+  },
+  {
+    name: "v1_create_material",
+    description: "Add a new material",
+    inputSchema: {
+      type: "object",
+      properties: {
+        brand: { type: "string" },
+        name: { type: "string" },
+        code: { type: "string" },
+        color_code: { type: "number" },
+        data_sheet: { type: "string" },
+        safety_sheet: { type: "string" },
+        origin_type: { type: "string" },
+        origin_country: { type: "string" },
+        waste_category: { type: "string" },
+        resin_id: { type: "string" },
+        chem_name: { type: "string" },
+        recycled: { type: "boolean" },
+        bioderived: { type: "boolean" },
+        biodegradable: { type: "string" },
+        biodegrade_comment: { type: "string" },
+        recyclable: { type: "boolean" },
+        recycle_info: { type: "string" },
+        recycle_url: { type: "string" },
+        recycling_img: { type: "string" },
+        bio_derived: { type: "string" },
+        buy_url: { type: "string" }
+      },
+      required: ["brand", "name", "origin_country"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.post('/api/material', null, { params: args });
+      return response.data;
+    }
+  },
+  {
+    name: "v1_get_material",
+    description: "Get information about a specific material",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/material/${args.id}`);
+      return response.data;
+    }
+  },
+  {
+    name: "v1_delete_material",
+    description: "Delete a specific material",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.delete(`/api/material/${args.id}`);
+      return response.data;
+    }
+  }
+];

package/src/tools/v1/product.ts

@@ -0,0 +1,87 @@
+import { McpTool } from '../types.js';
+
+export const productTools: McpTool[] = [
+  {
+    name: "v1_list_products",
+    description: "Show all products within a team. Also use this tool whenever the user mentions 'DPP', 'Digital Product Passports', 'digital twins', or wants to search their whatt.io product catalog.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    handler: async (_args, apiClient) => {
+      const response = await apiClient.get('/api/products');
+      return response.data;
+    }
+  },
+  {
+    name: "v1_create_product",
+    description: "Add a new product",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        product_number: { type: "string" },
+        version: { type: "string" },
+        description: { type: "string" },
+        gtin: { type: "string" },
+        image: { type: "string" },
+        video: { type: "string" },
+        buy_url: { type: "string" },
+        category_id: { type: "number" },
+        ai_description: { type: "string" },
+        type: { type: "string" },
+        public: { type: "number" }
+      },
+      required: ["name", "product_number", "description"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.post('/api/product', null, { params: args });
+      return response.data;
+    }
+  },
+  {
+    name: "v1_get_product",
+    description: "Get information about a specific product",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/product/${args.id}`);
+      return response.data;
+    }
+  },
+  {
+    name: "v1_get_ext_product",
+    description: "Get information about a specific product with extended format",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/product/ext/${args.id}`);
+      return response.data;
+    }
+  },
+  {
+    name: "v1_delete_product",
+    description: "Delete a specific product",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.delete(`/api/product/${args.id}`);
+      return response.data;
+    }
+  }
+];

package/src/tools/v1/simplyprint.ts

@@ -0,0 +1,46 @@
+import { McpTool } from '../types.js';
+
+export const simplyprintTools: McpTool[] = [
+  {
+    name: "v1_simplyprint_printers",
+    description: "Fetch SimplyPrint printers associated with user",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    handler: async (_args, apiClient) => {
+      const response = await apiClient.get('/api/simplyprint/printers');
+      return response.data;
+    }
+  },
+  {
+    name: "v1_simplyprint_jobs",
+    description: "Fetch SimplyPrint print jobs for a specific printer",
+    inputSchema: {
+      type: "object",
+      properties: {
+        printer_id: { type: "string", description: "Printer ID" }
+      },
+      required: ["printer_id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/simplyprint/jobs/${args.printer_id}`);
+      return response.data;
+    }
+  },
+  {
+    name: "v1_simplyprint_filament",
+    description: "Fetch remaining filament info for a specific printer",
+    inputSchema: {
+      type: "object",
+      properties: {
+        printer_id: { type: "string", description: "Printer ID" }
+      },
+      required: ["printer_id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/getFilament/filament/${args.printer_id}`);
+      return response.data;
+    }
+  }
+];

package/src/tools/v1/unit.ts

@@ -0,0 +1,69 @@
+import { McpTool } from '../types.js';
+
+export const unitTools: McpTool[] = [
+  {
+    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/src/tools/v1/user.ts

@@ -0,0 +1,48 @@
+import { McpTool } from '../types.js';
+
+export const userTools: McpTool[] = [
+  {
+    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/src/tools/v2/auth.ts

@@ -0,0 +1,77 @@
+import { McpTool } from '../types.js';
+
+export const authTools: McpTool[] = [
+  {
+    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/src/tools/v2/category.ts

@@ -0,0 +1,111 @@
+import { McpTool } from '../types.js';
+
+export const categoryTools: McpTool[] = [
+  {
+    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/src/tools/v2/device.ts

@@ -0,0 +1,99 @@
+import { McpTool } from '../types.js';
+
+export const deviceTools: McpTool[] = [
+  {
+    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/src/tools/v2/index.ts

@@ -0,0 +1,18 @@
+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';
+import { McpTool } from '../types.js';
+
+export const v2Tools: McpTool[] = [
+  ...authTools,
+  ...categoryTools,
+  ...deviceTools,
+  ...materialTools,
+  ...partTools,
+  ...productTools,
+  ...unitTools
+];