ShipBob

GitHub
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
  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