ShipStation API MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with the ShipStation API. This server provides tools and resources for managing orders, shipments, carriers, warehouses, products, customers, stores, webhooks, and fulfillments.

## Features

- Complete coverage of ShipStation API endpoints
- Structured tools for all API operations
- Documentation resources for API reference
- Error handling and logging

## Getting Started

1. Clone this repository
2. Install dependencies:
   ```
   npm install
   ```
3. Create a `.env` file with your ShipStation API credentials:
   ```
   SHIPSTATION_API_KEY=your_api_key
   SHIPSTATION_API_SECRET=your_api_secret
   ```
4. Run the server:
   ```
   npm run dev
   ```
5. Test with MCP Inspector:
   ```
   npm run inspect
   ```

## API Documentation

Access API documentation through the `shipstation://docs/{section}` resource. Available sections:

- overview
- orders
- shipments
- carriers
- warehouses
- products
- customers
- stores
- webhooks
- fulfillments

Example: `shipstation://docs/orders`

## Available Tools

### Orders
- list_orders
- get_order
- create_order
- mark_order_as_shipped
- delete_order
- add_tag_to_order
- remove_tag_from_order
- restore_order_from_hold
- hold_order_until

### Shipments
- list_shipments
- get_shipment
- create_label
- void_label

### Carriers
- list_carriers
- list_carrier_packages
- list_carrier_services

### Warehouses
- list_warehouses
- get_warehouse
- create_warehouse
- update_warehouse
- delete_warehouse

### Products
- list_products
- get_product
- create_product
- update_product
- delete_product

### Customers
- list_customers
- get_customer

### Stores
- list_stores
- get_store
- list_marketplaces
- refresh_store
- deactivate_store
- reactivate_store

### Webhooks
- list_webhooks
- subscribe_to_webhook
- unsubscribe_from_webhook

### Fulfillments
- list_fulfillments
- create_fulfillment_order

## License

MIT