ShipBoss
About
An intelligent shipping assistant for managing shipments, requiring a ShipBoss API token.
Details
- Author
- shipb
- Categories
- Productivity, API, Automation
Jump to
Setup
Install ShipBoss in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/shipb/shipboss_mcp_server
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server that provides shipping and logistics capabilities through AI conversations. Connect to FedEx, UPS, and DHL to get rates, create labels, track packages, and manage freight shipments.
🔑 Important: You'll need a ShipBoss API token to use this server. Get one from yourShipBoss Admin → API Integrations.
📁 This setup uses local development modewith virtual environment paths for maximum compatibility and control.
- Python 3.9+installed
- ShipBoss accountwith API token (get one in the admin section atship.shipboss.io)
Step 1: Get Your ShipBoss API Token🔑 This is required for the server to communicate with ShipBoss APIs.
- Go toShipBossand log in
- Navigate to your Admin section →API Integrations
- Generate a new API token and copy it
- Keep this token secure- you'll need it in the next step
Step 2: Create a Virtual Environment🐍 Using a virtual environment isrequiredto avoid dependency conflicts with your system Python installation.
# Create a virtual environment python -m venv shipboss_env # Activate it # Windows: shipboss_env\Scripts\activate # macOS/Linux: source shipboss_env/bin/activate # Install the package pip install shipboss-mcp-server
⚠️ Important: Using a virtual environment isrequiredto avoid dependency conflicts with your system Python installation.
Step 3: Configure API Token🔑 The server needs your API token to authenticate with ShipBoss. Choose one of these methods:
Option A: .env File (Simplest - Automatic) 📁
# Create environment file in the project directory echo "SHIPBOSS_API_TOKEN=your_api_token_here" > .env # Or use the provided template cp example.env .env # Then edit .env with your actual token
Then use this configuration in your MCP client:
{ "mcpServers": { "shipboss-mcp": { "command": "C:\\path\\to\\shipboss_env\\Scripts\\python.exe", "args": ["C:\\path\\to\\shipboss-mcp\\shipboss_mcp_server.py"] } } }
Add your token directly in the MCP configuration:
{ "mcpServers": { "shipboss-mcp": { "command": "C:\\path\\to\\shipboss_env\\Scripts\\python.exe", "args": [ "C:\\path\\to\\shipboss-mcp\\shipboss_mcp_server.py", "--api-token", "your_api_token_here" ] } } }
{ "mcpServers": { "shipboss-mcp": { "command": "C:\\path\\to\\shipboss_env\\Scripts\\python.exe", "args": ["C:\\path\\to\\shipboss-mcp\\shipboss_mcp_server.py"], "env": { "SHIPBOSS_API_TOKEN": "your_api_token_here" } } } }
Note: ReplaceC:\path\to\shipboss_envwith your actual virtual environment path andC:\path\to\shipboss-mcpwith your actual project directory path.
# Find your virtual environment Python executable cd shipboss_env\Scripts echo %CD%\python.exe # Find your project directory cd ..\.. echo %CD%\shipboss_mcp_server.py
# Find your virtual environment Python executable which python # Should show the venv python path # Find your project directory pwd # Current directory containing shipboss_mcp_server.py
# Test that your paths work "C:\path\to\shipboss_env\Scripts\python.exe" "C:\path\to\shipboss-mcp\shipboss_mcp_server.py" --api-token your_token_here
Step 4: Test Your Setup🧪 Make sure your virtual environment is activated, then restart your MCP client and try these commands:
- "Get shipping rates from New York to Los Angeles for a 2lb package"
- "Create a FedEx Ground label from 123 Main St, New York, NY to 456 Oak Ave, Los Angeles, CA"
- ping- Health check
- get_parcel_rates- Get parcel shipping rates
- create_parcel_label- Create parcel shipping labels with direct download URLs
- track_parcel- Track parcel shipments
- create_pickup- Schedule carrier pickups
- cancel_pickup- Cancel scheduled pickups
- get_freight_rates- Get freight shipping quotes
- track_freight- Track freight shipments
-
"python command not found" or "python.exe not found"❌: Make sure your virtual environment is activated before running the server.
- Solution: Activate your virtual environment first:
# Windows: shipboss_env\Scripts\activate # macOS/Linux: source shipboss_env/bin/activate
"API token required" error🔐: Make sure you have your API token configured using one of these methods:
- Easiest: Create a.envfile withSHIPBOSS_API_TOKEN=your_token(automatically loaded)
- Add--api-token your_tokento the args in your MCP config
- SetSHIPBOSS_API_TOKENin the env section of your MCP config
- Verify your token: Make sure it's fromShipBoss API Integrations
".env file not found": The.envfile should be in the project directory whereshipboss_mcp_server.pyis located, (or add the api key to the json config as detailed above.)
- Check if the file exists:ls -la .env
- Verify the token format:cat .env(should showSHIPBOSS_API_TOKEN=your_token_here)
Command not found: Ensure the package is installed and theshipboss-mcp-servercommand is available in your PATH.
Path issues in MCP configuration: Make sure your paths in the MCP config are correct:
- Use the full path to your virtual environment's Python executable
- Use the full path to yourshipboss_mcp_server.pyfile
- Ensure the paths use the correct separators (\for Windows,/for macOS/Linux)
Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.
Turn your Make scenarios into callable tools for AI assistants.
Dynamically search and call tools using UnifAI Network
WunderTrading MCP connects AI agents to live crypto trading execution on 20+ supported exchanges through a single MCP integration. Use it to turn AI-driven signals, market analysis, sentiment, screenshots, and custom strategy logic into real trades on exchanges including Binance, Bybit, Coinbase, Bitget, OKX, KuCoin, Hyperliquid, and BingX. Supports MCP and REST API workflows for order execution, trade management, and AI-powered automation.
Connect your AI Agents to 8,000 apps instantly.
Connect AI assistants to Automatisch for workflow automation.
Unified MCP gateway that loads 150+ AI tools into Claude Desktop via a single Docker command on Windows. Routes tool calls across specialized servers (Business Intelligence, API Hub, Content Automation, Intelligence) with centralized logging and governance. Built for teams without dedicated platform engineers.
Gherkio lets you describe HTTP-based integration tests as declarative YAML scenarios. Define requests, assertions, variable extractions, and orchestration. all in a simple, human-readable format that stays maintainable over time.
Connect AI assistants directly to the HiveFlow automation platform.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
