ShipStation API MCP Server

Implementation Reference

• src/tools/order-tools.js:40-52 (handler)

  The handler function for the 'get_order' MCP tool. It takes an orderId, fetches the order using shipStationClient.getOrder, stringifies it to JSON, and returns it in the expected MCP format. Handles errors by returning an error message.

  handler: async ({ orderId }) => {
    try {
      const order = await shipStationClient.getOrder(orderId);
      return {
        content: [{ type: "text", text: JSON.stringify(order, null, 2) }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: error.message }],
        isError: true
      };
    }
  }

• src/tools/order-tools.js:37-39 (schema)

  Zod input schema for the 'get_order' tool, validating that orderId is a required number.

  schema: {
    orderId: z.number().describe("Order ID to retrieve")
  },

• src/server.js:184-191 (registration)

  The registration logic in the MCP server that iterates over all tools (including 'get_order' from orderTools) and calls server.tool to register each one with its name, schema, handler, and description.

  ].forEach(tool => {
    server.tool(
      tool.name,
      tool.schema,
      tool.handler,
      { description: tool.description }
    );
  });

• src/api-client.js:52-54 (helper)

  Helper method in ShipStationClient that performs the actual API GET request to retrieve a specific order by ID from ShipStation's /orders/{orderId} endpoint.

  async getOrder(orderId) {
    return this.request('GET', `/orders/${orderId}`);
  }