ShipBob API MCP Server

Implementation Reference

• src/tools/fulfillment-tools.js:70-85 (handler)

  MCP tool handler for 'create_shipment' that calls the ShipBob API client to create a new shipment and returns success or error response.
  handler: async (shipmentData) => { try { const newShipment = await shipbobClient.createShipment(shipmentData); return { content: [{ type: "text", text: `Shipment created successfully: ${JSON.stringify(newShipment, null, 2)}` }] }; } catch (error) { return { content: [{ type: "text", text: `Error creating shipment: ${error.message}` }], isError: true }; } }
• src/tools/fulfillment-tools.js:59-69 (schema)

  Zod schema defining the input parameters for the create_shipment tool: orderId, optional fulfillmentCenterId, shippingMethod, and items array.
  schema: { orderId: z.string().describe("The ID of the order to create a shipment for"), fulfillmentCenterId: z.string().optional().describe("Preferred fulfillment center ID"), shippingMethod: z.string().describe("Shipping method to use"), items: z.array( z.object({ orderItemId: z.string().describe("Order item ID to ship"), quantity: z.number().describe("Quantity to ship") }) ).describe("Items to ship") },
• src/server.js:23-32 (registration)

  Utility function to register MCP tools from arrays like fulfillmentTools, which contains create_shipment. Called at line 53 for fulfillmentTools.
  const registerTools = (toolsArray) => { toolsArray.forEach(tool => { server.tool( tool.name, tool.schema, tool.handler, { description: tool.description } ); }); };
• src/server.js:53-53 (registration)

  Specific registration call for fulfillmentTools array, which includes the create_shipment tool.
  registerTools(fulfillmentTools);
• src/api-client.js:114-116 (helper)

  ShipBobClient helper method invoked by the tool handler to perform the actual POST request to the ShipBob /shipments API endpoint.
  async createShipment(shipmentData) { return this.request('POST', '/shipments', shipmentData); }