mattcoatsworth shipbob mcp server

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