Package Tracker by Spoke
Track a package from its tracking code and follow it on spokepackagetracker.com.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"package-tracker": {
"url": "https://spokepackagetracker.com/api/package-tracker/mcp"
}
}
}Remote endpoints
https://spokepackagetracker.com/api/package-tracker/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢track_package(trackingCode, carrierId, postalCode, destinationCode)
Gets one package's current status, courier, dates and event history from its tracking code, as spokepackagetracker.com shows them, with a link to that page. Without carrierId, it identifies the courier first: one match is tracked, several are returned as candidates without tracking, and none tries every tracking provider. Some couriers need the destination postal code or country, and the result lists them when they're missing. Every result has a trackingUrl; share it as a link in your reply so the user can follow the package.
Input Schema
{
"type": "object",
"properties": {
"trackingCode": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Package tracking number as printed by the courier or retailer. Spaces and dashes are ignored."
},
"carrierId": {
"description": "Courier ID, as returned in identify_courier couriers or track_package candidates.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"postalCode": {
"description": "Destination postal code, for couriers that need it.",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"destinationCode": {
"description": "Destination country as an ISO 3166-1 alpha-2 code, for couriers that need it.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"required": [
"trackingCode"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"result": {
"type": "string",
"enum": [
"tracked",
"courier_needed",
"fields_required",
"not_found"
]
},
"trackingCode": {
"type": "string"
},
"trackingUrl": {
"type": "string",
"format": "uri",
"description": "The package on spokepackagetracker.com. Share it with the user as a link."
},
"message": {
"type": "string"
},
"candidates": {
"description": "Couriers that may have issued the code",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"requiredFields": {
"type": "array",
"items": {
"type": "string",
"enum": [
"postalCode",
"destinationCode"
]
}
},
"package": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"pending",
"pre_transit",
"in_transit",
"preparing_for_delivery",
"available_for_pickup",
"out_for_delivery",
"delivery_successful",
"delivery_failed",
"returned_to_sender",
"cancelled",
"error"
]
},
"carrier": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"deliveryService": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"deliveryService"
],
"additionalProperties": false
},
"countryCode": {
"type": [
"string",
"null"
]
},
"shippingDate": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"expectedDeliveryDate": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"timeInTransit": {
"description": "Days in transit so far",
"type": [
"number",
"null"
]
},
"averageDeliveryTime": {
"description": "Average delivery time in days",
"type": [
"number",
"null"
]
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"addressLineOne": {
"type": [
"string",
"null"
]
},
"addressLineTwo": {
"type": [
"string",
"null"
]
},
"createdAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"required": [
"event",
"description",
"addressLineOne",
"addressLineTwo",
"createdAt"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"carrier",
"countryCode",
"shippingDate",
"expectedDeliveryDate",
"timeInTransit",
"averageDeliveryTime",
"history"
],
"additionalProperties": false
}
},
"required": [
"result",
"trackingCode",
"trackingUrl"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢identify_courier(trackingCode)
Identifies which couriers may have issued a package tracking code, from the code's format and a courier database. Returns each matching courier's ID and name, or an empty list when none matches. Does not look up the package's status.
Input Schema
{
"type": "object",
"properties": {
"trackingCode": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Package tracking number as printed by the courier or retailer. Spaces and dashes are ignored."
}
},
"required": [
"trackingCode"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"trackingCode": {
"type": "string"
},
"couriers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
}
},
"required": [
"trackingCode",
"couriers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence