@teamnetwork-nz/feenix-mcp-server 0.1.0

package/dist/tools/orders.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { jsonBlock } from '../format.js';
+import { quickOrderSchema } from '../schemas/quickorder.js';
+const bodyArg = {
+    body: z.record(z.unknown()).describe('Request document (JSON object) as accepted by the FeeniX API'),
+};
+// Quick Order search fields are CASE SENSITIVE (per the API docs).
+const SEARCH_FIELDS = [
+    'name',
+    'number',
+    'issueType',
+    'issueSubType',
+    'category',
+    'otherCategory',
+    'status',
+    'subStatus',
+    'waitingOn',
+    'customerReference',
+    'customerOrderReference',
+    'description',
+    'additionalInformation',
+    'team',
+    'nextAction',
+    'vendorStatus',
+];
+export const orderTools = [
+    {
+        name: 'feenix_quickorder_search',
+        description: 'Search orders by criteria. Field names are CASE SENSITIVE and include: ' +
+            SEARCH_FIELDS.join(', ') +
+            '. Pass any subset as `criteria`.',
+        inputSchema: z
+            .object({
+            criteria: z
+                .record(z.unknown())
+                .describe('Search criteria object, e.g. { "number": "ORD-123", "status": "Open" }'),
+        })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.get('/api/v2/quickorder/search', args.criteria);
+            return jsonBlock('Quick Order search', data);
+        },
+    },
+    {
+        name: 'feenix_quick_order',
+        description: '[write] Place a Quick Order (provision a service, churn, voice, modem, mesh). Fields map to the QuickOrder document; any unmodelled field may be supplied verbatim. Requires FEENIX_READWRITE=true.',
+        inputSchema: quickOrderSchema,
+        handler: async (client, args) => {
+            const data = await client.post('/api/v2/quickorder', args);
+            return jsonBlock('Quick Order result', data);
+        },
+    },
+    {
+        name: 'feenix_quick_order_subscriber',
+        description: '[write] Place a Quick Order that also creates/attaches a subscriber. Same document shape as feenix_quick_order. Requires FEENIX_READWRITE=true.',
+        inputSchema: quickOrderSchema,
+        handler: async (client, args) => {
+            const data = await client.post('/api/v2/quickorder/subscriber', args);
+            return jsonBlock('Quick Order (subscriber) result', data);
+        },
+    },
+    {
+        name: 'feenix_amend_order',
+        description: '[write] Amend an in-flight order identified by its task id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/issues/${encodeURIComponent(args.taskId)}/amend`, args.body);
+            return jsonBlock(`Amend order — task ${args.taskId}`, data);
+        },
+    },
+    {
+        name: 'feenix_cancel_order',
+        description: '[write] Cancel an in-flight order identified by its request id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z
+            .object({ requestId: z.string(), body: z.record(z.unknown()).optional() })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/issues/${encodeURIComponent(args.requestId)}/cancel`, args.body ?? {});
+            return jsonBlock(`Cancel order — request ${args.requestId}`, data);
+        },
+    },
+    // ---- Tail order (staged appointment-based provisioning) --------------------
+    {
+        name: 'feenix_tailorder_run_feasibility',
+        description: '[write] Run feasibility for a tail order (task id). Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), body: z.record(z.unknown()).optional() }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/tailorder/${encodeURIComponent(args.taskId)}/runFeasibility`, args.body ?? {});
+            return jsonBlock(`Tail order feasibility — task ${args.taskId}`, data);
+        },
+    },
+    {
+        name: 'feenix_tailorder_get_available_appointments',
+        description: '[write] Get available install appointments for a tail order (task id). Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), body: z.record(z.unknown()).optional() }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/tailorder/${encodeURIComponent(args.taskId)}/getAvailableAppointments`, args.body ?? {});
+            return jsonBlock(`Tail order appointments — task ${args.taskId}`, data);
+        },
+    },
+    {
+        name: 'feenix_tailorder_reserve_appointment',
+        description: '[write] Reserve an appointment for a tail order (task id). Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/tailorder/${encodeURIComponent(args.taskId)}/reserveAppointment`, args.body);
+            return jsonBlock(`Tail order reserve — task ${args.taskId}`, data);
+        },
+    },
+    {
+        name: 'feenix_tailorder_service_given',
+        description: '[write] Mark service-given for a tail order (task id). Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), body: z.record(z.unknown()).optional() }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/tailorder/${encodeURIComponent(args.taskId)}/serviceGiven`, args.body ?? {});
+            return jsonBlock(`Tail order service given — task ${args.taskId}`, data);
+        },
+    },
+    {
+        name: 'feenix_tailorder_order',
+        description: '[write] Submit the tail order (task id). Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v2/tailorder/${encodeURIComponent(args.taskId)}/order`, args.body);
+            return jsonBlock(`Tail order submit — task ${args.taskId}`, data);
+        },
+    },
+    {
+        name: 'feenix_modemorder_complete',
+        description: '[write] Complete a modem order (task id). Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ taskId: z.string(), body: z.record(z.unknown()).optional() }).strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v2/modemorder/${encodeURIComponent(args.taskId)}/complete`, args.body ?? {});
+            return jsonBlock(`Modem order complete — task ${args.taskId}`, data);
+        },
+    },
+];
+//# sourceMappingURL=orders.js.map

package/dist/tools/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../src/tools/orders.ts"],"names":[],"mappings":"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"}

package/dist/tools/products.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types.js';
+export declare const productTools: ToolDefinition[];
+//# sourceMappingURL=products.d.ts.map

package/dist/tools/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,eAAO,MAAM,YAAY,EAAE,cAAc,EA0DxC,CAAC"}

package/dist/tools/products.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { jsonBlock, modelsList } from '../format.js';
+const idArg = { productId: z.string().describe('Product _id') };
+const bodyArg = {
+    body: z.record(z.unknown()).describe('Product document (JSON object) as accepted by the FeeniX API'),
+};
+export const productTools = [
+    {
+        name: 'feenix_list_products',
+        description: 'List all products in the catalogue.',
+        inputSchema: z.object({}).strict(),
+        handler: async (client) => {
+            const data = await client.get('/api/v1/products');
+            return modelsList('Products', data, ['_id', 'name', 'number', 'productClass', 'category']);
+        },
+    },
+    {
+        name: 'feenix_get_product',
+        description: 'Get one product by its _id.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/products/${encodeURIComponent(args.productId)}`);
+            return jsonBlock(`Product ${args.productId}`, data);
+        },
+    },
+    {
+        name: 'feenix_get_product_variants_csv',
+        description: 'Get the product variants list as CSV (returned as raw text).',
+        inputSchema: z.object({}).strict(),
+        handler: async (client) => {
+            const data = await client.get('/api/v1/products/variantsListCsv');
+            return jsonBlock('Product variants (CSV)', data);
+        },
+    },
+    {
+        name: 'feenix_create_product',
+        description: '[write] Create a new product. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(bodyArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.post('/api/v1/products', args.body);
+            return jsonBlock('Created product', data);
+        },
+    },
+    {
+        name: 'feenix_update_product',
+        description: '[write] Update an existing product by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ ...idArg, ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.put(`/api/v1/products/${encodeURIComponent(args.productId)}`, args.body);
+            return jsonBlock(`Updated product ${args.productId}`, data);
+        },
+    },
+    {
+        name: 'feenix_delete_product',
+        description: '[write] Delete a product by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.delete(`/api/v1/products/${encodeURIComponent(args.productId)}`);
+            return jsonBlock(`Deleted product ${args.productId}`, data ?? { deleted: true });
+        },
+    },
+];
+//# sourceMappingURL=products.js.map

package/dist/tools/products.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"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"}

package/dist/tools/services.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types.js';
+export declare const serviceTools: ToolDefinition[];
+//# sourceMappingURL=services.d.ts.map

package/dist/tools/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/tools/services.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO7C,eAAO,MAAM,YAAY,EAAE,cAAc,EAuIxC,CAAC"}

package/dist/tools/services.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { jsonBlock, modelsList } from '../format.js';
+const bodyArg = {
+    body: z.record(z.unknown()).describe('Request document (JSON object) as accepted by the FeeniX API'),
+};
+export const serviceTools = [
+    {
+        name: 'feenix_list_services',
+        description: 'List all sold services.',
+        inputSchema: z.object({}).strict(),
+        handler: async (client) => {
+            const data = await client.get('/api/v1/services');
+            return modelsList('Services', data, ['_id', 'name', 'number', 'status']);
+        },
+    },
+    {
+        name: 'feenix_get_service',
+        description: 'Get one sold service by its service _id.',
+        inputSchema: z.object({ serviceId: z.string().describe('Service _id') }).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/services/${encodeURIComponent(args.serviceId)}`);
+            return jsonBlock(`Service ${args.serviceId}`, data);
+        },
+    },
+    {
+        name: 'feenix_service_linetest',
+        description: 'Run a line test on the fibre connection of an active subscriber, identified by soldServiceId (same id used for suspend/decommission).',
+        inputSchema: z.object({ soldServiceId: z.string().describe('The soldServiceId of the service') }).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/services/${encodeURIComponent(args.soldServiceId)}/linetest`);
+            return jsonBlock(`Line test — service ${args.soldServiceId}`, data);
+        },
+    },
+    {
+        name: 'feenix_create_service',
+        description: '[write] Create a service. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(bodyArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.post('/api/v1/services', args.body);
+            return jsonBlock('Created service', data);
+        },
+    },
+    {
+        name: 'feenix_update_service',
+        description: '[write] Update a service by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ serviceId: z.string(), ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.put(`/api/v1/services/${encodeURIComponent(args.serviceId)}`, args.body);
+            return jsonBlock(`Updated service ${args.serviceId}`, data);
+        },
+    },
+    {
+        name: 'feenix_delete_service',
+        description: '[write] Delete a service by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ serviceId: z.string() }).strict(),
+        handler: async (client, args) => {
+            const data = await client.delete(`/api/v1/services/${encodeURIComponent(args.serviceId)}`);
+            return jsonBlock(`Deleted service ${args.serviceId}`, data ?? { deleted: true });
+        },
+    },
+    {
+        name: 'feenix_change_product',
+        description: '[write] Change the product on a completed service (soldServiceId). Requires FEENIX_READWRITE=true.',
+        inputSchema: z
+            .object({
+            soldServiceId: z.string().describe('The soldServiceId of the service to change'),
+            soldProduct: z.string().describe('New sold product _id'),
+            tailProduct: z.string().optional().describe('New tail product _id'),
+            tailVariant: z.string().optional().describe('New tail variant _id'),
+            targetDate: z.string().optional().describe('Requested change date, e.g. "2020-06-01T09:00:00" (NZT)'),
+        })
+            .passthrough(),
+        handler: async (client, args) => {
+            const { soldServiceId, ...body } = args;
+            const data = await client.post(`/api/v1/services/${encodeURIComponent(soldServiceId)}/changeProduct`, body);
+            return jsonBlock(`Change product — service ${soldServiceId}`, data);
+        },
+    },
+    {
+        name: 'feenix_change_attributes',
+        description: '[write] Change attributes on a service (serviceId). Requires FEENIX_READWRITE=true.',
+        inputSchema: z
+            .object({
+            serviceId: z.string().describe('The serviceId to change'),
+            productAttributes: z
+                .array(z.object({ name: z.string(), value: z.unknown() }).passthrough())
+                .describe('Array of {name, value} attribute objects'),
+            targetDate: z.string().optional().describe('Requested change date (NZT)'),
+        })
+            .passthrough(),
+        handler: async (client, args) => {
+            const { serviceId, ...body } = args;
+            const data = await client.post(`/api/v1/services/${encodeURIComponent(serviceId)}/changeAttributes`, body);
+            return jsonBlock(`Change attributes — service ${serviceId}`, data);
+        },
+    },
+    {
+        name: 'feenix_suspend_service',
+        description: '[write] Suspend a completed order/service (soldServiceId). Requires FEENIX_READWRITE=true.',
+        inputSchema: z
+            .object({ soldServiceId: z.string(), body: z.record(z.unknown()).optional() })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/services/${encodeURIComponent(args.soldServiceId)}/suspend`, args.body ?? {});
+            return jsonBlock(`Suspend — service ${args.soldServiceId}`, data);
+        },
+    },
+    {
+        name: 'feenix_decommission_service',
+        description: '[write] Decommission a completed order/service (soldServiceId). Requires FEENIX_READWRITE=true.',
+        inputSchema: z
+            .object({ soldServiceId: z.string(), body: z.record(z.unknown()).optional() })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.post(`/api/v1/services/${encodeURIComponent(args.soldServiceId)}/decommission`, args.body ?? {});
+            return jsonBlock(`Decommission — service ${args.soldServiceId}`, data);
+        },
+    },
+];
+//# sourceMappingURL=services.js.map

package/dist/tools/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../src/tools/services.ts"],"names":[],"mappings":"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"}

package/dist/tools/subscribers.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types.js';
+export declare const subscriberTools: ToolDefinition[];
+//# sourceMappingURL=subscribers.d.ts.map

package/dist/tools/subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/tools/subscribers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,eAAO,MAAM,eAAe,EAAE,cAAc,EAgG3C,CAAC"}

package/dist/tools/subscribers.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+import { jsonBlock, modelsList } from '../format.js';
+const idArg = { subscriberId: z.string().describe('Subscriber _id') };
+const bodyArg = {
+    body: z.record(z.unknown()).describe('Subscriber document (JSON object) as accepted by the FeeniX API'),
+};
+export const subscriberTools = [
+    {
+        name: 'feenix_list_subscribers',
+        description: 'List all subscribers.',
+        inputSchema: z.object({}).strict(),
+        handler: async (client) => {
+            const data = await client.get('/api/v1/subscribers');
+            return modelsList('Subscribers', data, ['_id', 'subscriberName', 'username', 'status']);
+        },
+    },
+    {
+        name: 'feenix_get_subscriber',
+        description: 'Get one subscriber by _id.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/subscribers/${encodeURIComponent(args.subscriberId)}`);
+            return jsonBlock(`Subscriber ${args.subscriberId}`, data);
+        },
+    },
+    {
+        name: 'feenix_get_subscriber_status',
+        description: 'Get the current status of a subscriber by _id.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/subscribers/${encodeURIComponent(args.subscriberId)}/status`);
+            return jsonBlock(`Subscriber status ${args.subscriberId}`, data);
+        },
+    },
+    {
+        name: 'feenix_get_subscriber_data_usage',
+        description: 'Get data-usage information for a subscriber by _id.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/subscribers/${encodeURIComponent(args.subscriberId)}/dataUsage`);
+            return jsonBlock(`Subscriber data usage ${args.subscriberId}`, data);
+        },
+    },
+    {
+        name: 'feenix_get_subscriber_logs',
+        description: 'Get RADIUS auth logs for a subscriber, filtered by a query object (e.g. { "username": "user@example.com" }).',
+        inputSchema: z
+            .object({ query: z.record(z.unknown()).describe('Log filter, e.g. { "username": "test@feenix.co.nz" }') })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.get('/api/subscribers/logs', { q: JSON.stringify(args.query) });
+            return jsonBlock('Subscriber RADIUS logs', data);
+        },
+    },
+    {
+        name: 'feenix_bulk_data_usage',
+        description: 'Look up data usage for many subscribers in one call. Body is the bulk request document (e.g. a list of subscriber ids/usernames). This is a read-only query (not gated).',
+        inputSchema: z
+            .object({ body: z.record(z.unknown()).describe('Bulk data-usage request document') })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.postQuery('/api/v1/subscribers/bulkDataUsage', args.body);
+            return jsonBlock('Bulk data usage', data);
+        },
+    },
+    {
+        name: 'feenix_create_subscriber',
+        description: '[write] Create a subscriber. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(bodyArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.post('/api/v1/subscribers', args.body);
+            return jsonBlock('Created subscriber', data);
+        },
+    },
+    {
+        name: 'feenix_update_subscriber',
+        description: '[write] Update a subscriber by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ ...idArg, ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.put(`/api/v1/subscribers/${encodeURIComponent(args.subscriberId)}`, args.body);
+            return jsonBlock(`Updated subscriber ${args.subscriberId}`, data);
+        },
+    },
+    {
+        name: 'feenix_delete_subscriber',
+        description: '[write] Delete a subscriber by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.delete(`/api/v1/subscribers/${encodeURIComponent(args.subscriberId)}`);
+            return jsonBlock(`Deleted subscriber ${args.subscriberId}`, data ?? { deleted: true });
+        },
+    },
+];
+//# sourceMappingURL=subscribers.js.map

package/dist/tools/subscribers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.js","sourceRoot":"","sources":["../../src/tools/subscribers.ts"],"names":[],"mappings":"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"}

package/dist/tools/vendors.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types.js';
+export declare const vendorTools: ToolDefinition[];
+//# sourceMappingURL=vendors.d.ts.map

package/dist/tools/vendors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendors.d.ts","sourceRoot":"","sources":["../../src/tools/vendors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,eAAO,MAAM,WAAW,EAAE,cAAc,EAkEvC,CAAC"}

package/dist/tools/vendors.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { jsonBlock, modelsList } from '../format.js';
+const idArg = { vendorId: z.string().describe('Vendor _id') };
+const bodyArg = {
+    body: z.record(z.unknown()).describe('Vendor document (JSON object) as accepted by the FeeniX API'),
+};
+export const vendorTools = [
+    {
+        name: 'feenix_list_vendors',
+        description: 'List all vendor records.',
+        inputSchema: z.object({}).strict(),
+        handler: async (client) => {
+            const data = await client.get('/api/v1/vendors');
+            return modelsList('Vendors', data, ['_id', 'name', 'number', 'country']);
+        },
+    },
+    {
+        name: 'feenix_get_vendor',
+        description: 'Get one vendor by _id.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/vendors/${encodeURIComponent(args.vendorId)}`);
+            return jsonBlock(`Vendor ${args.vendorId}`, data);
+        },
+    },
+    {
+        name: 'feenix_get_losing_service_provider',
+        description: 'Get the Losing Service Provider (LSP) for a vendor and technology (e.g. "fibre"). Used during a churn/transfer.',
+        inputSchema: z
+            .object({
+            vendorId: z.string().describe('Vendor _id'),
+            technology: z.string().describe('Technology, e.g. "fibre"'),
+        })
+            .strict(),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/vendors/${encodeURIComponent(args.vendorId)}/lsp/${encodeURIComponent(args.technology)}`);
+            return jsonBlock(`Losing Service Provider — vendor ${args.vendorId} / ${args.technology}`, data);
+        },
+    },
+    {
+        name: 'feenix_create_vendor',
+        description: '[write] Create a vendor. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(bodyArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.post('/api/v1/vendors', args.body);
+            return jsonBlock('Created vendor', data);
+        },
+    },
+    {
+        name: 'feenix_update_vendor',
+        description: '[write] Update a vendor by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object({ ...idArg, ...bodyArg }).strict(),
+        handler: async (client, args) => {
+            const data = await client.put(`/api/v1/vendors/${encodeURIComponent(args.vendorId)}`, args.body);
+            return jsonBlock(`Updated vendor ${args.vendorId}`, data);
+        },
+    },
+    {
+        name: 'feenix_delete_vendor',
+        description: '[write] Delete a vendor by _id. Requires FEENIX_READWRITE=true.',
+        inputSchema: z.object(idArg).strict(),
+        handler: async (client, args) => {
+            const data = await client.delete(`/api/v1/vendors/${encodeURIComponent(args.vendorId)}`);
+            return jsonBlock(`Deleted vendor ${args.vendorId}`, data ?? { deleted: true });
+        },
+    },
+];
+//# sourceMappingURL=vendors.js.map

package/dist/tools/vendors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendors.js","sourceRoot":"","sources":["../../src/tools/vendors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;AAC9D,MAAM,OAAO,GAAG;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,6DAA6D,CAAC;CACpG,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,iBAAiB,CAAC,CAAC;YAC1D,OAAO,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3E,CAAC;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/F,OAAO,SAAS,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;KACF;IACD;QACE,IAAI,EAAE,oCAAoC;QAC1C,WAAW,EACT,iHAAiH;QACnH,WAAW,EAAE,CAAC;aACX,MAAM,CAAC;YACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SAC5D,CAAC;aACD,MAAM,EAAE;QACX,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAClG,CAAC;YACF,OAAO,SAAS,CAAC,oCAAoC,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;QACnG,CAAC;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE;QACvC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACtE,OAAO,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACxD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EACtD,IAAI,CAAC,IAAI,CACV,CAAC;YACF,OAAO,SAAS,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAU,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClG,OAAO,SAAS,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;KACF;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: any;
+    handler: (client: import('./client.js').FeenixClient, args: any) => Promise<string>;
+}
+export interface ServerSideQuery {
+    serverSideFilter?: Record<string, unknown>;
+    serverSidePaginateInfo?: {
+        limit?: number;
+        page?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,GAAG,CAAC;IAEjB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrF;AAGD,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// FeeniX Public API responses are loosely-typed JSON documents whose exact shapes vary
+// by tenant and product. The tools render results generically (see format.ts), so this
+// module keeps only the plumbing contract plus a couple of light shared shapes.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,uFAAuF;AACvF,gFAAgF"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@teamnetwork-nz/feenix-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for the FeeniX Public API (NZ fibre/broadband wholesale ordering, provisioning & billing) with a read-only gate",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "feenix-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "feenix",
+    "fibre",
+    "broadband",
+    "ordering",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "axios": "^1.7.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.15.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}