A comprehensive Model Context Protocol (MCP) server for interacting with ShipBob's e-commerce fulfillment API. ## Features This MCP server provides tools and resources for all major ShipBob API functionalities: - **Products**: Manage your product catalog - **Orders**: Create and manage orders - **Inventory**: Track and adjust inventory levels - **Fulfillment**: Manage shipments and fulfillment processes - **Webhooks**: Configure notifications for ShipBob events - **Returns**: Process and manage return requests - **Locations**: Access information about fulfillment centers - **Channels**: Manage sales channels - **Reporting**: Generate and retrieve reports ## Getting Started ### Prerequisites - Node.js 16 or higher - ShipBob API key (obtain from your ShipBob dashboard) ### Installation 1. Clone this repository 2. Install dependencies: ``` npm install ``` 3. Create a `.env` file with your ShipBob API key: ``` SHIPBOB_API_KEY=your_api_key_here ``` ### Running the Server Start the server: ``` npm run dev ``` ### Testing with MCP Inspector Test the server using the MCP Inspector: ``` npm run inspect ``` This will open a web interface where you can: - Browse available tools and resources - Test tools with custom inputs - View server logs and responses ## Available Tools ### Product Management - `list_products`: List products in your ShipBob inventory - `get_product`: Get details of a specific product - `create_product`: Create a new product - `update_product`: Update an existing product ### Order Management - `list_orders`: List orders in your ShipBob account - `get_order`: Get details of a specific order - `create_order`: Create a new order - `cancel_order`: Cancel an existing order ### Inventory Management - `get_inventory`: Get inventory information across all fulfillment centers - `get_product_inventory`: Get inventory for a specific product - `get_inventory_levels`: Get current inventory levels for all products - `adjust_inventory`: Make inventory adjustments ### Fulfillment - `list_shipments`: List shipments in your account - `get_shipment`: Get details of a specific shipment - `create_shipment`: Create a new shipment ### Webhooks - `list_webhooks`: List all configured webhooks - `create_webhook`: Create a new webhook - `delete_webhook`: Delete an existing webhook ### Returns - `list_returns`: List returns in your account - `get_return`: Get details of a specific return - `create_return`: Create a new return ### Locations - `list_fulfillment_centers`: List all fulfillment centers - `get_fulfillment_center`: Get details of a specific fulfillment center ### Channels - `list_channels`: List all sales channels - `get_channel`: Get details of a specific sales channel ### Reporting - `get_inventory_report`: Get inventory report - `get_orders_report`: Get orders report - `get_shipping_report`: Get shipping report ## Available Resources - `shipbob://docs/{section}`: Access documentation about ShipBob API - Available sections: overview, authentication, products, orders, inventory, fulfillment, webhooks, returns, locations, channels, reporting ## License MIT