ShipHero MCP Server

by mattcoatsworth

405 downloads

Not rated

GitHub

Other

Description

# ShipHero MCP Server A comprehensive Model Context Protocol (MCP) server for interacting with the ShipHero API. ## Features - Complete coverage of ShipHero API endpoints - Authentication handling with automatic token refresh - Rate limiting support - Comprehensive error…

About

Details

Author: mattcoatsworth
Downloads: 405
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name ShipHero MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

From the repository

Install via npm install shiphero-mcp-server, create a .env file with SHIPHERO_API_KEY and SHIPHERO_API_SECRET, then run with npx shiphero-mcp. You can also test with npx @modelcontextprotocol/inspector npx shiphero-mcp.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "shiphero mcp server": {
            "Shiphero-mcp-server": {
                "command": "npx",
                "args": [
                    "shiphero-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "Shiphero-mcp-server": {
        "command": "npx",
        "args": [
            "shiphero-mcp"
        ]
    }
}

ShipHero MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with the ShipHero API.

## Features

- Complete coverage of ShipHero API endpoints
- Authentication handling with automatic token refresh
- Rate limiting support
- Comprehensive error handling
- Documentation resources

## Installation

    npm install shiphero-mcp-server

## Configuration

Create a .env file with your ShipHero API credentials:

    SHIPHERO_API_KEY=your_api_key_here
    SHIPHERO_API_SECRET=your_api_secret_here

## Usage

### Running the server

    npx shiphero-mcp

### Testing with MCP Inspector

    npx @modelcontextprotocol/inspector npx shiphero-mcp

## Available Tools

### Orders
- get_order: Retrieve a specific order by ID
- list_orders: List orders with optional filtering
- create_order: Create a new order
- update_order: Update an existing order
- cancel_order: Cancel an order

### Products
- get_product: Retrieve a specific product by ID
- list_products: List products with optional filtering
- create_product: Create a new product
- update_product: Update an existing product
- delete_product: Delete a product

### Inventory
- get_inventory: Get inventory levels for a product
- adjust_inventory: Adjust inventory levels
- list_inventory_movements: List inventory movements
- get_inventory_by_location: Get inventory by warehouse location

### Shipping
- get_shipment: Retrieve a specific shipment by ID
- list_shipments: List shipments with optional filtering
- create_shipment: Create a new shipment
- get_shipping_rates: Get shipping rates for a package
- create_return: Create a return shipment

### Warehouses
- list_warehouses: List all warehouses
- get_warehouse: Get details for a specific warehouse
- list_locations: List locations within a warehouse

### Vendors
- list_vendors: List all vendors
- get_vendor: Get details for a specific vendor
- create_vendor: Create a new vendor
- update_vendor: Update an existing vendor

### Webhooks
- list_webhooks: List all webhook subscriptions
- create_webhook: Create a new webhook subscription
- delete_webhook: Delete a webhook subscription

## Documentation Resources

Access documentation through the shiphero://docs/{section} resource, where {section} can be:
- overview: General API overview
- orders: Orders API documentation
- products: Products API documentation
- inventory: Inventory API documentation
- shipping: Shipping API documentation
- warehouses: Warehouses API documentation
- vendors: Vendors API documentation
- webhooks: Webhooks API documentation

## License

MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

ShipHero MCP Server

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀