AfterShip

AfterShip MCP Server for Cloudflare Workers

Available Tools

20 tools available in the AfterShip MCP server. Each tool can be called by AI assistants to perform specific actions.

aftership_list_all_couriers

List all couriers supported by AfterShip (over 1000+).

Returns the complete list of all couriers AfterShip supports, regardless of your account activation status.

Args:

format: Response format ('json' or 'markdown')

Returns: Array of all supported courier objects.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

aftership_mark_as_completed

Mark a tracking as completed with a specific reason.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)
reason: Completion reason (required): DELIVERED, LOST, or RETURNED_TO_SENDER

Returns: The updated tracking object.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_get_last_checkpoint

Get the last checkpoint for a tracking.

Returns the most recent checkpoint/status update for a tracking, which is more efficient than fetching the full tracking when you only need the current status.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)
fields: Comma-separated list of checkpoint fields to return Available fields: slug, created_at, checkpoint_time, city, coordinates, country_iso3, country_name, message, state, tag, zip
lang: Language for checkpoint messages (e.g., 'en')
format: Response format ('json' or 'markdown')

Returns: Last checkpoint object with tracking info and the most recent checkpoint.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "lang": {
      "type": "string",
      "description": "Language for checkpoint messages"
    },
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated checkpoint fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_get_last_checkpoint_by_id

Get the last checkpoint for a tracking by AfterShip ID.

Args:

id: AfterShip tracking ID (required)
fields: Comma-separated list of checkpoint fields to return
lang: Language for checkpoint messages
format: Response format

Returns: Last checkpoint object with tracking info and the most recent checkpoint.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "AfterShip tracking ID (required)"
    },
    "lang": {
      "type": "string",
      "description": "Language for checkpoint messages"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated checkpoint fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

aftership_list_couriers

List couriers activated in your AfterShip account.

Returns a list of couriers that you have activated for your account.

Args:

format: Response format ('json' or 'markdown')

Returns: Array of courier objects with slug, name, phone, web_url, and required fields.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

aftership_detect_couriers

Detect which couriers match a tracking number format.

Given a tracking number, returns a list of possible couriers that use that tracking number format.

Args:

tracking_number: The tracking number to detect (required)
tracking_postal_code: Postal code (helps narrow detection)
tracking_ship_date: Ship date in YYYYMMDD format
tracking_account_number: Account number with courier
tracking_destination_country: Destination country code
slug: Array of courier slugs to limit detection to

Returns: Array of detected courier objects with slug and name.

{
  "type": "object",
  "required": [
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Limit detection to these courier slugs"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number to detect (required)"
    },
    "tracking_ship_date": {
      "type": "string",
      "description": "Ship date (YYYYMMDD)"
    },
    "tracking_postal_code": {
      "type": "string",
      "description": "Postal code"
    },
    "tracking_account_number": {
      "type": "string",
      "description": "Account number with courier"
    },
    "tracking_destination_country": {
      "type": "string",
      "description": "Destination country code"
    }
  }
}

aftership_get_tracking

Get a tracking by courier slug and tracking number.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)
fields: Comma-separated list of fields to return
lang: Language for checkpoint messages (e.g., 'en')
format: Response format ('json' or 'markdown')

Returns: The tracking object with checkpoints.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "lang": {
      "type": "string",
      "description": "Language for checkpoint messages"
    },
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_predict_edd

Predict estimated delivery dates for shipments.

Uses AfterShip's AI-powered predictive model to estimate when packages will be delivered. Can predict for multiple shipments in a single request (max 5).

Args:

predictions: Array of prediction requests (1-5 items), each containing:
- slug: Courier slug (required)
- service_type_name: Service type name
- origin_address: Origin address with country, state, and/or postal_code
- destination_address: Destination address with country, state, and/or postal_code
- weight: Weight object with unit ('kg' or 'lb') and value
- pickup_time: Local pickup time (ISO 8601) OR
- estimated_pickup: Estimated pickup date (YYYY-MM-DD)

Note: Either pickup_time or estimated_pickup is required for each prediction. Either origin_address.state or origin_address.postal_code is required. Either destination_address.state or destination_address.postal_code is required.

Returns: Array of prediction results with estimated_delivery_date, estimated_delivery_date_max, and confidence_score.

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "unit": {
      "enum": [
        "kg",
        "lb"
      ],
      "type": "string",
      "description": "Weight unit"
    },
    "state": {
      "type": "string",
      "description": "Destination state/province"
    },
    "value": {
      "type": "number",
      "description": "Weight value"
    },
    "country": {
      "type": "string",
      "description": "Destination country ISO3 code"
    },
    "pickup_time": {
      "type": "string",
      "description": "Local pickup time (ISO 8601)"
    },
    "postal_code": {
      "type": "string",
      "description": "Destination postal code"
    },
    "estimated_pickup": {
      "type": "string",
      "description": "Estimated pickup date (YYYY-MM-DD)"
    },
    "service_type_name": {
      "type": "string",
      "description": "Service type name"
    }
  }
}

aftership_get_notification

Get notification settings for a tracking.

Returns the email addresses and phone numbers that will receive notifications for this tracking.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)

Returns: Notification object with emails and smses arrays.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_get_notification_by_id

Get notification settings for a tracking by AfterShip ID.

Args:

id: AfterShip tracking ID (required)

Returns: Notification object with emails and smses arrays.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "AfterShip tracking ID (required)"
    }
  }
}

aftership_add_notification

Add notification receivers to a tracking.

Adds email addresses and/or phone numbers to receive tracking updates.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)
emails: Array of email addresses to add
smses: Array of phone numbers to add (with country code, e.g., +1234567890)

Returns: Updated notification object.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "smses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Phone numbers to add"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to add"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_add_notification_by_id

Add notification receivers to a tracking by AfterShip ID.

Args:

id: AfterShip tracking ID (required)
emails: Array of email addresses to add
smses: Array of phone numbers to add

Returns: Updated notification object.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "AfterShip tracking ID (required)"
    },
    "smses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Phone numbers to add"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to add"
    }
  }
}

aftership_retrack

Retrack an expired tracking. Can be called up to 3 times per tracking.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)

Returns: The retracked tracking object.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_remove_notification

Remove notification receivers from a tracking.

Removes specified email addresses and/or phone numbers from receiving tracking updates.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)
emails: Array of email addresses to remove
smses: Array of phone numbers to remove

Returns: Updated notification object.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "smses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Phone numbers to remove"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to remove"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_remove_notification_by_id

Remove notification receivers from a tracking by AfterShip ID.

Args:

id: AfterShip tracking ID (required)
emails: Array of email addresses to remove
smses: Array of phone numbers to remove

Returns: Updated notification object.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "AfterShip tracking ID (required)"
    },
    "smses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Phone numbers to remove"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to remove"
    }
  }
}

aftership_create_tracking

Create a new tracking in AfterShip.

Args:

tracking_number: The tracking number (required)
slug: Courier slug (e.g., 'ups', 'fedex', 'usps')
title: A title for this tracking
customer_name: Customer name
order_id: Order ID
order_number: Order number
emails: Array of email addresses for notifications
smses: Array of phone numbers for SMS notifications
custom_fields: Custom key-value pairs

Returns: The created tracking object.

{
  "type": "object",
  "required": [
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (e.g., ups, fedex, usps)"
    },
    "smses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Phone numbers for SMS notifications"
    },
    "title": {
      "type": "string",
      "description": "Title for the tracking"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses for notifications"
    },
    "order_id": {
      "type": "string",
      "description": "Order ID"
    },
    "order_number": {
      "type": "string",
      "description": "Order number"
    },
    "customer_name": {
      "type": "string",
      "description": "Customer name"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_get_tracking_by_id

Get a tracking by its AfterShip ID.

Args:

id: AfterShip tracking ID (required)
fields: Comma-separated list of fields to return
lang: Language for checkpoint messages
format: Response format

Returns: The tracking object with checkpoints.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "AfterShip tracking ID (required)"
    },
    "lang": {
      "type": "string",
      "description": "Language for checkpoint messages"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

aftership_list_trackings

List trackings with optional filters.

Args:

page: Page number (1-indexed)
limit: Number of trackings per page (max 200)
slug: Filter by courier slug
tag: Filter by status tag (Pending, InTransit, Delivered, etc.)
keyword: Search keyword
created_at_min: Filter by created date (ISO 8601)
created_at_max: Filter by created date (ISO 8601)
origin: Filter by origin country
destination: Filter by destination country
format: Response format

Status tags: Pending, InfoReceived, InTransit, OutForDelivery, AttemptFail, Delivered, AvailableForPickup, Exception, Expired

Returns: Paginated list of trackings.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (1-indexed)"
    },
    "slug": {
      "type": "string",
      "description": "Filter by courier slug"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Number per page (max 200)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "origin": {
      "type": "string",
      "description": "Filter by origin country"
    },
    "keyword": {
      "type": "string",
      "description": "Search keyword"
    },
    "destination": {
      "type": "string",
      "description": "Filter by destination country"
    },
    "created_at_max": {
      "type": "string",
      "description": "Created before (ISO 8601)"
    },
    "created_at_min": {
      "type": "string",
      "description": "Created after (ISO 8601)"
    }
  }
}

aftership_update_tracking

Update a tracking by courier slug and tracking number.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)
title: New title
customer_name: New customer name
order_id: New order ID
order_number: New order number
emails: New email addresses for notifications
smses: New phone numbers for SMS
custom_fields: New custom fields

Returns: The updated tracking object.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "smses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New phone numbers"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New email addresses"
    },
    "order_id": {
      "type": "string",
      "description": "New order ID"
    },
    "order_number": {
      "type": "string",
      "description": "New order number"
    },
    "custom_fields": {
      "type": "object",
      "description": "New custom fields"
    },
    "customer_name": {
      "type": "string",
      "description": "New customer name"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}

aftership_delete_tracking

Delete a tracking by courier slug and tracking number.

Args:

slug: Courier slug (required)
tracking_number: Tracking number (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "slug",
    "tracking_number"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Courier slug (required)"
    },
    "tracking_number": {
      "type": "string",
      "description": "Tracking number (required)"
    }
  }
}