Allows for adding FedEx tracking numbers to a Parcel account and monitoring their status, including real-time delivery updates and exception tracking.
Allows for adding UPS tracking numbers to a Parcel account and monitoring their status, including real-time delivery updates and exception tracking.
Allows for adding USPS tracking numbers to a Parcel account and monitoring their status, including real-time delivery updates and exception tracking.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Parcel MCP ServerShow me the status of my active deliveries"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Parcel MCP Server
An MCP (Model Context Protocol) server for the Parcel delivery tracking API. This server allows AI assistants to interact with your Parcel account to add deliveries and track their status.
Features
This MCP server provides four tools:
1. add_delivery
Add a new delivery to Parcel for tracking.
Parameters:
tracking_number(required): Tracking number for the deliverycarrier_code(required): Carrier code (e.g., 'ups', 'fedex', 'usps', 'pholder' for placeholder)description(required): Description for the deliverylanguage(optional): Language code (ISO 639-1, e.g., 'en', 'es'). Default: ensend_push_confirmation(optional): Set to true to receive a push notification. Default: false
Note: Rate limit is 20 requests per day.
2. get_deliveries
Get your recent or active deliveries from Parcel.
Parameters:
filter_mode(optional): 'active' for active deliveries or 'recent' for recent ones. Default: 'recent'
Note: Rate limit is 20 requests per hour.
3. get_supported_carriers
Get the list of supported carriers and their codes.
No parameters required.
4. get_delivery_status_codes
Get the meaning of delivery status codes (0-8).
No parameters required.
Installation
Prerequisites
A Parcel premium account
An API key from web.parcelapp.net
Using Smithery (Recommended)
Install the server using Smithery CLI:
You'll be prompted to enter your Parcel API key during the installation flow.
The API key is securely passed to the server via Smithery's configuration system.
Local Testing
For local development and testing, the server supports environment variables:
Clone this repository
Build the server:
Add to your MCP client configuration (e.g., Claude Desktop):
Note: The PARCEL_API_KEY environment variable is intended for testing only. Production deployments should use Smithery's configuration flow.
Development
Local Development
This will start the server with hot-reload using Smithery's development mode.
Building
API Rate Limits
Add Delivery: 20 requests per day
Get Deliveries: 20 requests per hour
Delivery Status Codes
0: Completed delivery
1: Frozen delivery (no recent updates)
2: Delivery in transit
3: Delivery expecting a pickup by the recipient
4: Out for delivery
5: Delivery not found
6: Failed delivery attempt
7: Delivery exception (requires attention)
8: Carrier has received information but not the physical package yet
Resources
License
MIT