ShipStation API MCP Server

Implementation Reference

• src/tools/store-tools.js:47-59 (handler)

  The handler function that implements the 'list_marketplaces' tool logic. It calls shipStationClient.getMarketplaces() and returns the marketplaces as JSON or an error message.

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

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

  The registration code that spreads the storeTools array (containing list_marketplaces) and registers all tools with the MCP server using server.tool().

  [
    ...orderTools,
    ...shipmentTools,
    ...carrierTools,
    ...warehouseTools,
    ...productTools,
    ...customerTools,
    ...storeTools,
    ...webhookTools,
    ...fulfillmentTools
  ].forEach(tool => {
    server.tool(
      tool.name,
      tool.schema,
      tool.handler,
      { description: tool.description }
    );
  });

• src/api-client.js:174-176 (helper)

  The helper method on ShipStationClient that makes the API request to fetch marketplaces, called by the tool handler.

  async getMarketplaces() {
    return this.request('GET', '/stores/marketplaces');
  }