ShipStation API MCP Server

Implementation Reference

• src/tools/store-tools.js:67-79 (handler)

  The main handler function for the 'refresh_store' MCP tool. It invokes shipStationClient.refreshStore(storeId), formats the result as JSON text content, and handles errors appropriately.

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

• src/tools/store-tools.js:64-66 (schema)

  Zod schema defining the input parameter 'storeId' as a required number for the refresh_store tool.

  schema: {
    storeId: z.number().describe("Store ID to refresh")
  },

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

  Registration loop in the MCP server that registers all tools, including 'refresh_store' from the storeTools array, by calling server.tool() with name, schema, handler, and description.

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

• src/api-client.js:178-180 (helper)

  Helper method in ShipStationClient that performs the actual API call to refresh the store data via POST /stores/refreshstore.

  async refreshStore(storeId) {
    return this.request('POST', '/stores/refreshstore', { storeId });
  }