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 delivery
• carrier_code (required): Carrier code (e.g., 'ups', 'fedex', 'usps', 'pholder' for placeholder)
• description (required): Description for the delivery
• language (optional): Language code (ISO 639-1, e.g., 'en', 'es'). Default: en
• send_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)

1. Install the server using Smithery CLI:

smithery install parcel-mcp-server --client <your-client>

2. 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:

1. Clone this repository
2. Build the server:

npm install
npm run build

3. Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "parcel": {
      "command": "node",
      "args": ["/path/to/parcel-mcp-server/dist/index.js"],
      "env": {
        "PARCEL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: The PARCEL_API_KEY environment variable is intended for testing only. Production deployments should use Smithery's configuration flow.

Development

Local Development

npm install
npm run dev

This will start the server with hot-reload using Smithery's development mode.

Building

npm run build

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

• Parcel API Documentation - Add Delivery
• Parcel API Documentation - View Deliveries
• Supported Carriers List

License

MIT