ShipStation API MCP Server
# 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
TDQS
Scored across 39 tools
Every tool has a clearly distinct purpose targeting specific resources and actions in the ShipStation domain. There is no ambiguity between tools like 'get_order' vs 'list_orders' or 'create_order' vs 'mark_order_as_shipped', as each handles a unique operation on well-defined entities.
Tool names follow a highly consistent verb_noun pattern throughout, such as 'create_order', 'list_orders', 'get_order', 'delete_order'. Minor variations like 'add_tag_to_order' or 'hold_order_until' maintain readability and adhere to the same overall naming convention without mixing styles.
With 39 tools, the count is borderline high for typical MCP server scope, potentially overwhelming for agents. While it covers many aspects of ShipStation's API, it might benefit from consolidation or categorization to reduce cognitive load, placing it in the 16-25+ range that feels heavy.
The tool set provides comprehensive CRUD and lifecycle coverage for the ShipStation domain, including orders, products, warehouses, stores, shipments, and webhooks. It supports full workflows from creation to deletion, with no obvious gaps that would cause agent failures in typical e-commerce operations.