ShipBob API 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

       

       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