@whattio/mcp-server 1.0.0

package/src/tools/v2/material.ts

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

@@ -0,0 +1,104 @@
+import { McpTool } from '../types.js';
+
+export const partTools: McpTool[] = [
+  {
+    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;
+    }
+  }
+];

package/src/tools/v2/product.ts

@@ -0,0 +1,101 @@
+import { McpTool } from '../types.js';
+
+export const productTools: McpTool[] = [
+  {
+    name: "v2_list_products",
+    description: "Retrieve a paginated list of all products belonging to the authenticated user's current team. Also use this tool whenever the user mentions 'DPP', 'Digital Product Passports', 'digital twins', or wants to search their whatt.io catalog.",
+    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/product', { params: args });
+      return response.data;
+    }
+  },
+  {
+    name: "v2_create_product",
+    description: "Create a new product",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        product_number: { type: "string" },
+        description: { type: "string" },
+        gtin_number: { type: "string" },
+        category_id: { type: "number" },
+        ai_description: { type: "string" },
+        buy_link: { type: "string" },
+        video_url: { type: "string" },
+        primaryMaterial: { type: "number" },
+        secondaryMaterial: { type: "number" },
+        public: { type: "boolean" }
+      },
+      required: ["name", "product_number", "description"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.post('/api/v2/product/create', args);
+      return response.data;
+    }
+  },
+  {
+    name: "v2_show_product",
+    description: "Get detailed information about a specific product",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Product ID" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/v2/product/${args.id}/show`);
+      return response.data;
+    }
+  },
+  {
+    name: "v2_update_product",
+    description: "Update the details of an existing product",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Product ID" },
+        name: { type: "string" },
+        product_number: { type: "string" },
+        description: { type: "string" },
+        gtin_number: { type: "string" },
+        category_id: { type: "number" },
+        ai_description: { type: "string" },
+        buy_link: { type: "string" },
+        video_url: { type: "string" },
+        primaryMaterial: { type: "number" },
+        secondaryMaterial: { type: "number" },
+        public: { type: "boolean" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const { id, ...data } = args;
+      const response = await apiClient.post(`/api/v2/product/${id}/update`, { ...data, _method: 'PUT' });
+      return response.data;
+    }
+  },
+  {
+    name: "v2_delete_product",
+    description: "Delete a product from the system",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Product ID" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.delete(`/api/v2/product/${args.id}/delete`);
+      return response.data;
+    }
+  }
+];

package/src/tools/v2/unit.ts

@@ -0,0 +1,88 @@
+import { McpTool } from '../types.js';
+
+export const unitTools: McpTool[] = [
+  {
+    name: "v2_list_units",
+    description: "Retrieve a paginated list of all product units",
+    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/unit', { params: args });
+      return response.data;
+    }
+  },
+  {
+    name: "v2_create_unit",
+    description: "Create a new product unit",
+    inputSchema: {
+      type: "object",
+      properties: {
+        serial: { type: "string" },
+        product_id: { type: "number" },
+        parts: { type: "string", description: "JSON string of component parts used in this unit" },
+        public: { type: "boolean" }
+      },
+      required: ["serial", "product_id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.post('/api/v2/unit/create', args);
+      return response.data;
+    }
+  },
+  {
+    name: "v2_show_unit",
+    description: "Get detailed information about a specific unit",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Unit ID" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.get(`/api/v2/unit/${args.id}/show`);
+      return response.data;
+    }
+  },
+  {
+    name: "v2_update_unit",
+    description: "Update the details of an existing product unit instance",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Unit ID" },
+        serial: { type: "string" },
+        product_id: { type: "number" },
+        parts: { type: "string" },
+        public: { type: "boolean" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const { id, ...data } = args;
+      // The openapi explicitly shows PUT for this endpoint for v2
+      const response = await apiClient.put(`/api/v2/unit/${id}/update`, data);
+      return response.data;
+    }
+  },
+  {
+    name: "v2_delete_unit",
+    description: "Permanently delete a unit from the system",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "number", description: "Unit ID" }
+      },
+      required: ["id"]
+    },
+    handler: async (args, apiClient) => {
+      const response = await apiClient.delete(`/api/v2/unit/${args.id}/delete`);
+      return response.data;
+    }
+  }
+];

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}