@burdenoff/mcp-libs 2026.1030.4 → 2026.1030.5

package/dist/modules/movethewheels/index.cjs

@@ -125,13 +125,14 @@ var INVENTORY_TRANSACTION_FIELDS = `
   id transactionNumber type productId warehouseId inventoryItemId quantity
   unitCost referenceType referenceId notes ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
 `;
+var MARKETPLACE_AUDIT_FIELDS = `workspaceId createdBy onBehalfOf updatedBy createdAt updatedAt deletedAt`;
 var SERVICE_OFFERING_FIELDS = `
-  id name providerId category description price currency availability
-  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+  id providerId name description category price currency pricingUnit transitDays
+  availability isActive ${MARKETPLACE_AUDIT_FIELDS}
 `;
 var SERVICE_PROVIDER_FIELDS = `
-  id name type description isActive isVerified rating services contactInfo
-  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+  id name type description rating contactInfo services serviceAreas isVerified isActive
+  offeringsCount ${MARKETPLACE_AUDIT_FIELDS}
 `;
 var REPORT_FIELDS = `
   id name type status description configuration schedule lastGenerated
@@ -495,19 +496,19 @@ var GET_SERVICE_PROVIDER = `
 `;
 var LIST_SERVICE_PROVIDERS = `
   query MovethewheelsListServiceProviders(
-    $filter: ServiceProviderFilterInput
+    $filter: MtwServiceProviderFilterInput
     $pagination: PaginationInput
   ) {
     serviceProviders(filter: $filter, pagination: $pagination) { ${SERVICE_PROVIDER_FIELDS} }
   }
 `;
 var CREATE_SERVICE_PROVIDER = `
-  mutation MovethewheelsCreateServiceProvider($input: CreateServiceProviderInput!) {
+  mutation MovethewheelsCreateServiceProvider($input: MtwCreateServiceProviderInput!) {
     createServiceProvider(input: $input) { ${SERVICE_PROVIDER_FIELDS} }
   }
 `;
 var UPDATE_SERVICE_PROVIDER = `
-  mutation MovethewheelsUpdateServiceProvider($id: ID!, $input: UpdateServiceProviderInput!) {
+  mutation MovethewheelsUpdateServiceProvider($id: ID!, $input: MtwUpdateServiceProviderInput!) {
     updateServiceProvider(id: $id, input: $input) { ${SERVICE_PROVIDER_FIELDS} }
   }
 `;
@@ -520,25 +521,28 @@ var GET_SERVICE_OFFERING = `
   query MovethewheelsGetServiceOffering($id: ID!) {
     serviceOffering(id: $id) {
       ${SERVICE_OFFERING_FIELDS}
-      provider { id name type }
+      provider { id name type isVerified isActive }
     }
   }
 `;
 var LIST_SERVICE_OFFERINGS = `
   query MovethewheelsListServiceOfferings(
-    $filter: ServiceOfferingFilterInput
+    $filter: MtwServiceOfferingFilterInput
     $pagination: PaginationInput
   ) {
-    serviceOfferings(filter: $filter, pagination: $pagination) { ${SERVICE_OFFERING_FIELDS} }
+    serviceOfferings(filter: $filter, pagination: $pagination) {
+      ${SERVICE_OFFERING_FIELDS}
+      provider { id name type isVerified }
+    }
   }
 `;
 var CREATE_SERVICE_OFFERING = `
-  mutation MovethewheelsCreateServiceOffering($input: CreateServiceOfferingInput!) {
+  mutation MovethewheelsCreateServiceOffering($input: MtwCreateServiceOfferingInput!) {
     createServiceOffering(input: $input) { ${SERVICE_OFFERING_FIELDS} }
   }
 `;
 var UPDATE_SERVICE_OFFERING = `
-  mutation MovethewheelsUpdateServiceOffering($id: ID!, $input: UpdateServiceOfferingInput!) {
+  mutation MovethewheelsUpdateServiceOffering($id: ID!, $input: MtwUpdateServiceOfferingInput!) {
     updateServiceOffering(id: $id, input: $input) { ${SERVICE_OFFERING_FIELDS} }
   }
 `;
@@ -547,6 +551,19 @@ var DELETE_SERVICE_OFFERING = `
     deleteServiceOffering(id: $id)
   }
 `;
+var MARKETPLACE_STATS = `
+  query MovethewheelsMarketplaceStats {
+    marketplaceStats { providers verifiedProviders activeProviders offerings avgRating }
+  }
+`;
+var ASSIGN_SHIPMENT_SERVICE_PROVIDER = `
+  mutation MovethewheelsAssignShipmentServiceProvider($shipmentId: ID!, $providerId: ID) {
+    assignShipmentServiceProvider(shipmentId: $shipmentId, providerId: $providerId) {
+      id shipmentNumber status carrierId
+      serviceProvider { id name type isVerified isActive deletedAt }
+    }
+  }
+`;
 var GET_REPORT = `
   query MovethewheelsGetReport($id: ID!) {
     movethewheelsReport(id: $id) { ${REPORT_FIELDS} }
@@ -696,6 +713,30 @@ var VehicleTypeEnum = zod.z.enum([
   "VAN"
 ]).describe("Class of vehicle in the fleet");
 var WarehouseTypeEnum = zod.z.enum(["COLD_STORAGE", "CROSS_DOCK", "DISTRIBUTION", "FULFILLMENT", "RETAIL"]).describe("Type of warehouse facility");
+var ServiceProviderTypeEnum = zod.z.enum([
+  "CARRIER",
+  "FREIGHT_FORWARDER",
+  "THIRD_PARTY_LOGISTICS",
+  "WAREHOUSE",
+  "CUSTOMS_BROKER",
+  "LAST_MILE",
+  "COURIER",
+  "OTHER"
+]).describe("Kind of marketplace service provider");
+var ServiceOfferingCategoryEnum = zod.z.enum([
+  "FULL_TRUCKLOAD",
+  "LESS_THAN_TRUCKLOAD",
+  "LAST_MILE",
+  "EXPRESS",
+  "OCEAN_FREIGHT",
+  "AIR_FREIGHT",
+  "RAIL_FREIGHT",
+  "WAREHOUSING",
+  "CUSTOMS_CLEARANCE",
+  "COLD_CHAIN",
+  "OTHER"
+]).describe("What a marketplace service offering provides");
+var ServiceAvailabilityEnum = zod.z.enum(["AVAILABLE", "LIMITED", "UNAVAILABLE"]).describe("Whether the provider currently has capacity for an offering");
 var JsonObject = zod.z.record(zod.z.string(), zod.z.unknown());
 var JsonValue = zod.z.union([JsonObject, zod.z.array(zod.z.unknown())]);
 
@@ -2922,12 +2963,28 @@ function registerInventoryTools(server, ctx, track) {
     }
   );
 }
+var Rating = zod.z.number().min(0).max(5);
+var Tags = zod.z.array(zod.z.string().min(1));
+var Currency = zod.z.string().regex(/^[A-Za-z]{3}$/).describe('ISO 4217 currency code, e.g. "INR" or "USD"');
+function definedOnly(source) {
+  const out = {};
+  for (const [key, value] of Object.entries(source)) {
+    if (value !== void 0) out[key] = value;
+  }
+  return out;
+}
+function failure(ctx, tool, action, error) {
+  ctx.logger.error(`movethewheels ${tool} failed`, { error: String(error) });
+  return errorResult(
+    `Failed to ${action}: ${error instanceof Error ? error.message : String(error)}`
+  );
+}
 function registerMarketplaceTools(server, ctx, track) {
   server.registerTool(
     track(mcpToolName(ctx.productName, "marketplace_get_provider")),
     {
       title: "Get Service Provider",
-      description: "Fetch a single logistics service provider by ID, including its offerings.",
+      description: "Fetch a single marketplace service provider by ID, including its offerings.",
       inputSchema: { id: zod.z.string().describe("Service provider ID") }
     },
     async ({ id }) => {
@@ -2936,10 +2993,7 @@ function registerMarketplaceTools(server, ctx, track) {
         if (!data.serviceProvider) return errorResult(`Service provider ${id} not found`);
         return jsonResult(data.serviceProvider);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_get_provider failed", { error: String(error) });
-        return errorResult(
-          `Failed to get service provider: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_get_provider", "get service provider", error);
       }
     }
   );
@@ -2947,33 +3001,27 @@ function registerMarketplaceTools(server, ctx, track) {
     track(mcpToolName(ctx.productName, "marketplace_list_providers")),
     {
       title: "List Service Providers",
-      description: "List logistics service providers with optional type/active/text filters and pagination.",
+      description: "List marketplace service providers with optional type/verified/active/rating/text filters and pagination.",
       inputSchema: {
-        search: zod.z.string().optional().describe("Free-text search across name/description"),
-        type: zod.z.string().optional().describe("Filter by provider type"),
+        search: zod.z.string().optional().describe("Case-insensitive match on name, description, services and service areas"),
+        type: ServiceProviderTypeEnum.optional(),
+        isVerified: zod.z.boolean().optional().describe("Only verified (or unverified) providers"),
         isActive: zod.z.boolean().optional().describe("Filter by active flag"),
-        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
-        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+        minRating: Rating.optional().describe("Only providers rated at least this (0-5)"),
+        limit: zod.z.number().int().positive().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().min(0).optional().describe("Pagination offset (default 0)")
       }
     },
-    async ({ search, type, isActive, limit, offset }) => {
+    async ({ search, type, isVerified, isActive, minRating, limit, offset }) => {
       try {
-        const filter = {};
-        if (search !== void 0) filter.search = search;
-        if (type !== void 0) filter.type = type;
-        if (isActive !== void 0) filter.isActive = isActive;
+        const filter = definedOnly({ search, type, isVerified, isActive, minRating });
         const data = await ctx.gql.workspace.request(LIST_SERVICE_PROVIDERS, {
           filter: Object.keys(filter).length > 0 ? filter : void 0,
           pagination: { limit: limit ?? 50, offset: offset ?? 0 }
         });
         return jsonResult(data.serviceProviders);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_list_providers failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to list service providers: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_list_providers", "list service providers", error);
       }
     }
   );
@@ -2981,36 +3029,27 @@ function registerMarketplaceTools(server, ctx, track) {
     track(mcpToolName(ctx.productName, "marketplace_create_provider")),
     {
       title: "Create Service Provider",
-      description: "Onboard a logistics service provider. `name` and `type` are required; `isActive` defaults to true, `isVerified` to false.",
+      description: "Add a service provider to the workspace marketplace directory. `name` and `type` are required; `isActive` defaults to true, `isVerified` to false.",
       inputSchema: {
         name: zod.z.string().min(1).describe("Provider name"),
-        type: zod.z.string().min(1).describe('Provider type, e.g. "carrier", "broker"'),
+        type: ServiceProviderTypeEnum,
         description: zod.z.string().optional().describe("Description"),
-        isActive: zod.z.boolean().optional().describe("Active flag (default true)"),
+        rating: Rating.optional().describe("The workspace's own rating, 0-5"),
+        contactInfo: JsonObject.optional().describe(
+          "Contact details, e.g. { contactName, email, phone, website }"
+        ),
+        services: Tags.optional().describe('Short service tags, e.g. ["reefer", "hazmat"]'),
+        serviceAreas: Tags.optional().describe("Regions, lanes or cities covered"),
         isVerified: zod.z.boolean().optional().describe("Verified flag (default false)"),
-        rating: zod.z.number().optional().describe("Rating"),
-        services: JsonObject.optional().describe("Services JSON"),
-        contactInfo: JsonObject.optional().describe("Contact info JSON")
+        isActive: zod.z.boolean().optional().describe("Active flag (default true)")
       }
     },
-    async ({ name, type, description, isActive, isVerified, rating, services, contactInfo }) => {
+    async (args) => {
       try {
-        const input = { name, type };
-        if (description !== void 0) input.description = description;
-        if (isActive !== void 0) input.isActive = isActive;
-        if (isVerified !== void 0) input.isVerified = isVerified;
-        if (rating !== void 0) input.rating = rating;
-        if (services !== void 0) input.services = services;
-        if (contactInfo !== void 0) input.contactInfo = contactInfo;
-        const data = await ctx.gql.workspace.request(CREATE_SERVICE_PROVIDER, { input });
+        const data = await ctx.gql.workspace.request(CREATE_SERVICE_PROVIDER, { input: definedOnly(args) });
         return jsonResult(data.createServiceProvider);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_create_provider failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to create service provider: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_create_provider", "create service provider", error);
       }
     }
   );
@@ -3021,49 +3060,27 @@ function registerMarketplaceTools(server, ctx, track) {
       description: "Update a service provider. At least one mutable field must be provided.",
       inputSchema: {
         id: zod.z.string().describe("Service provider ID"),
-        name: zod.z.string().optional().describe("Updated name"),
-        type: zod.z.string().optional().describe("Updated type"),
+        name: zod.z.string().min(1).optional().describe("Updated name"),
+        type: ServiceProviderTypeEnum.optional(),
         description: zod.z.string().optional().describe("Updated description"),
-        isActive: zod.z.boolean().optional().describe("Updated active flag"),
+        rating: Rating.optional().describe("Updated rating, 0-5"),
+        contactInfo: JsonObject.optional().describe("Updated contact details"),
+        services: Tags.optional().describe("Replacement service tags"),
+        serviceAreas: Tags.optional().describe("Replacement service areas"),
         isVerified: zod.z.boolean().optional().describe("Updated verified flag"),
-        rating: zod.z.number().optional().describe("Updated rating"),
-        services: JsonObject.optional().describe("Updated services JSON"),
-        contactInfo: JsonObject.optional().describe("Updated contact info JSON")
+        isActive: zod.z.boolean().optional().describe("Updated active flag")
       }
     },
-    async ({
-      id,
-      name,
-      type,
-      description,
-      isActive,
-      isVerified,
-      rating,
-      services,
-      contactInfo
-    }) => {
+    async ({ id, ...rest }) => {
       try {
-        const input = {};
-        if (name !== void 0) input.name = name;
-        if (type !== void 0) input.type = type;
-        if (description !== void 0) input.description = description;
-        if (isActive !== void 0) input.isActive = isActive;
-        if (isVerified !== void 0) input.isVerified = isVerified;
-        if (rating !== void 0) input.rating = rating;
-        if (services !== void 0) input.services = services;
-        if (contactInfo !== void 0) input.contactInfo = contactInfo;
+        const input = definedOnly(rest);
         if (Object.keys(input).length === 0) {
           return errorResult("No updates specified \u2014 provide at least one mutable field.");
         }
         const data = await ctx.gql.workspace.request(UPDATE_SERVICE_PROVIDER, { id, input });
         return jsonResult(data.updateServiceProvider);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_update_provider failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to update service provider: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_update_provider", "update service provider", error);
       }
     }
   );
@@ -3071,7 +3088,7 @@ function registerMarketplaceTools(server, ctx, track) {
     track(mcpToolName(ctx.productName, "marketplace_delete_provider")),
     {
       title: "Delete Service Provider",
-      description: "Soft-delete a service provider by ID.",
+      description: "Soft-delete a service provider and its offerings. Shipments that already use it as carrier keep the reference.",
       inputSchema: { id: zod.z.string().describe("Service provider ID") }
     },
     async ({ id }) => {
@@ -3082,12 +3099,7 @@ function registerMarketplaceTools(server, ctx, track) {
         );
         return jsonResult({ deleted: data.deleteServiceProvider, id });
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_delete_provider failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to delete service provider: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_delete_provider", "delete service provider", error);
       }
     }
   );
@@ -3104,10 +3116,7 @@ function registerMarketplaceTools(server, ctx, track) {
         if (!data.serviceOffering) return errorResult(`Service offering ${id} not found`);
         return jsonResult(data.serviceOffering);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_get_offering failed", { error: String(error) });
-        return errorResult(
-          `Failed to get service offering: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_get_offering", "get service offering", error);
       }
     }
   );
@@ -3115,33 +3124,28 @@ function registerMarketplaceTools(server, ctx, track) {
     track(mcpToolName(ctx.productName, "marketplace_list_offerings")),
     {
       title: "List Service Offerings",
-      description: "List service offerings with optional provider/category/text filters and pagination.",
+      description: "List service offerings with optional provider/category/availability/price/text filters and pagination.",
       inputSchema: {
-        search: zod.z.string().optional().describe("Free-text search across name/description"),
+        search: zod.z.string().optional().describe("Case-insensitive match on name and description"),
         providerId: zod.z.string().optional().describe("Filter by provider ID"),
-        category: zod.z.string().optional().describe("Filter by category"),
-        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
-        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+        category: ServiceOfferingCategoryEnum.optional(),
+        availability: ServiceAvailabilityEnum.optional(),
+        isActive: zod.z.boolean().optional().describe("Filter by active flag"),
+        maxPrice: zod.z.number().min(0).optional().describe("Only offerings at or below this price"),
+        limit: zod.z.number().int().positive().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().min(0).optional().describe("Pagination offset (default 0)")
       }
     },
-    async ({ search, providerId, category, limit, offset }) => {
+    async ({ limit, offset, ...rest }) => {
       try {
-        const filter = {};
-        if (search !== void 0) filter.search = search;
-        if (providerId !== void 0) filter.providerId = providerId;
-        if (category !== void 0) filter.category = category;
+        const filter = definedOnly(rest);
         const data = await ctx.gql.workspace.request(LIST_SERVICE_OFFERINGS, {
           filter: Object.keys(filter).length > 0 ? filter : void 0,
           pagination: { limit: limit ?? 50, offset: offset ?? 0 }
         });
         return jsonResult(data.serviceOfferings);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_list_offerings failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to list service offerings: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_list_offerings", "list service offerings", error);
       }
     }
   );
@@ -3149,33 +3153,26 @@ function registerMarketplaceTools(server, ctx, track) {
     track(mcpToolName(ctx.productName, "marketplace_create_offering")),
     {
       title: "Create Service Offering",
-      description: 'Create a service offering for a provider. `name`, `price`, and `providerId` are required; `currency` defaults to "USD".',
+      description: 'Publish a service offering for a provider. `providerId`, `name` and `category` are required; omit `price` when priced on request. `currency` defaults to "USD", `availability` to AVAILABLE.',
       inputSchema: {
-        name: zod.z.string().min(1).describe("Offering name"),
-        price: zod.z.number().describe("Price"),
         providerId: zod.z.string().min(1).describe("Owning provider ID"),
-        category: zod.z.string().optional().describe("Category"),
+        name: zod.z.string().min(1).describe("Offering name"),
+        category: ServiceOfferingCategoryEnum,
         description: zod.z.string().optional().describe("Description"),
-        currency: zod.z.string().optional().describe('Currency (default "USD")'),
-        availability: JsonObject.optional().describe("Availability JSON")
+        price: zod.z.number().min(0).optional().describe("Indicative price in `currency`"),
+        currency: Currency.optional(),
+        pricingUnit: zod.z.string().optional().describe('What the price is charged per, e.g. "per km" or "per pallet"'),
+        transitDays: zod.z.number().int().min(0).optional().describe("Typical transit time in days"),
+        availability: ServiceAvailabilityEnum.optional(),
+        isActive: zod.z.boolean().optional().describe("Active flag (default true)")
       }
     },
-    async ({ name, price, providerId, category, description, currency, availability }) => {
+    async (args) => {
       try {
-        const input = { name, price, providerId };
-        if (category !== void 0) input.category = category;
-        if (description !== void 0) input.description = description;
-        if (currency !== void 0) input.currency = currency;
-        if (availability !== void 0) input.availability = availability;
-        const data = await ctx.gql.workspace.request(CREATE_SERVICE_OFFERING, { input });
+        const data = await ctx.gql.workspace.request(CREATE_SERVICE_OFFERING, { input: definedOnly(args) });
         return jsonResult(data.createServiceOffering);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_create_offering failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to create service offering: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_create_offering", "create service offering", error);
       }
     }
   );
@@ -3186,37 +3183,27 @@ function registerMarketplaceTools(server, ctx, track) {
       description: "Update a service offering. At least one mutable field must be provided.",
       inputSchema: {
         id: zod.z.string().describe("Service offering ID"),
-        name: zod.z.string().optional().describe("Updated name"),
-        price: zod.z.number().optional().describe("Updated price"),
-        providerId: zod.z.string().optional().describe("Updated provider ID"),
-        category: zod.z.string().optional().describe("Updated category"),
+        name: zod.z.string().min(1).optional().describe("Updated name"),
+        category: ServiceOfferingCategoryEnum.optional(),
         description: zod.z.string().optional().describe("Updated description"),
-        currency: zod.z.string().optional().describe("Updated currency"),
-        availability: JsonObject.optional().describe("Updated availability JSON")
+        price: zod.z.number().min(0).optional().describe("Updated price"),
+        currency: Currency.optional(),
+        pricingUnit: zod.z.string().optional().describe("Updated pricing unit"),
+        transitDays: zod.z.number().int().min(0).optional().describe("Updated transit days"),
+        availability: ServiceAvailabilityEnum.optional(),
+        isActive: zod.z.boolean().optional().describe("Updated active flag")
       }
     },
-    async ({ id, name, price, providerId, category, description, currency, availability }) => {
+    async ({ id, ...rest }) => {
       try {
-        const input = {};
-        if (name !== void 0) input.name = name;
-        if (price !== void 0) input.price = price;
-        if (providerId !== void 0) input.providerId = providerId;
-        if (category !== void 0) input.category = category;
-        if (description !== void 0) input.description = description;
-        if (currency !== void 0) input.currency = currency;
-        if (availability !== void 0) input.availability = availability;
+        const input = definedOnly(rest);
         if (Object.keys(input).length === 0) {
           return errorResult("No updates specified \u2014 provide at least one mutable field.");
         }
         const data = await ctx.gql.workspace.request(UPDATE_SERVICE_OFFERING, { id, input });
         return jsonResult(data.updateServiceOffering);
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_update_offering failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to update service offering: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_update_offering", "update service offering", error);
       }
     }
   );
@@ -3235,12 +3222,42 @@ function registerMarketplaceTools(server, ctx, track) {
         );
         return jsonResult({ deleted: data.deleteServiceOffering, id });
       } catch (error) {
-        ctx.logger.error("movethewheels marketplace_delete_offering failed", {
-          error: String(error)
-        });
-        return errorResult(
-          `Failed to delete service offering: ${error instanceof Error ? error.message : String(error)}`
-        );
+        return failure(ctx, "marketplace_delete_offering", "delete service offering", error);
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_stats")),
+    {
+      title: "Marketplace Stats",
+      description: "Counts of providers (total, verified, active) and live offerings, plus the average provider rating.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(MARKETPLACE_STATS, {});
+        return jsonResult(data.marketplaceStats);
+      } catch (error) {
+        return failure(ctx, "marketplace_stats", "get marketplace stats", error);
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_assign_shipment")),
+    {
+      title: "Assign Provider to Shipment",
+      description: "Make a marketplace provider the shipment's carrier, or clear the carrier by passing providerId null. Unverified or inactive providers are allowed; check their flags first.",
+      inputSchema: {
+        shipmentId: zod.z.string().min(1).describe("Shipment ID"),
+        providerId: zod.z.string().min(1).nullable().describe("Service provider ID, or null to clear the carrier")
+      }
+    },
+    async ({ shipmentId, providerId }) => {
+      try {
+        const data = await ctx.gql.workspace.request(ASSIGN_SHIPMENT_SERVICE_PROVIDER, { shipmentId, providerId });
+        return jsonResult(data.assignShipmentServiceProvider);
+      } catch (error) {
+        return failure(ctx, "marketplace_assign_shipment", "assign provider to shipment", error);
       }
     }
   );