Sorted MCP by usefulapi
Register, update and search shipments; read tracking events and states in Sorted.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"sorted": {
"url": "https://sorted.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://sorted.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (9)
🟢sorted_get_shipment(shipment_id)
Get one registered shipment by its Track id: state, carrier, dates, addresses, references and metadata. Track API: GET /shipments/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"minLength": 1,
"description": "Track shipment id, for example sp_… (from sorted_search_shipments)."
}
},
"required": [
"shipment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sorted_search_shipments(start, end, tracking_references, custom_references, metadata_key, ...)
List shipments, optionally in a date window (start and end together, max 14 days), or filter by tracking or custom reference or by metadata. Use page for more results. Track API: GET /shipments/search.
Eingabe-Schema
{
"type": "object",
"properties": {
"start": {
"description": "Range start, ISO 8601 (for example 2026-11-01T00:00:00Z). Optional; send with end.",
"type": "string"
},
"end": {
"description": "Range end, ISO 8601. Optional; send with start. The range may not exceed 14 days.",
"type": "string"
},
"tracking_references": {
"description": "Tracking references. A shipment must contain all of them to match.",
"type": "array",
"items": {
"type": "string"
}
},
"custom_references": {
"description": "Your own custom references. A shipment must contain all of them to match.",
"type": "array",
"items": {
"type": "string"
}
},
"metadata_key": {
"type": "string"
},
"metadata_value": {
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sorted_get_event(event_id)
Get one tracking event by its Track event id. Track API: GET /events/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"minLength": 1,
"description": "Track event id (from sorted_get_shipment_events)."
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sorted_search_events(start, end, tracking_references, custom_references, carrier)
List tracking events, optionally in a date window (start and end together, max 14 days), filtered by tracking or custom reference or carrier. Track API: GET /events/search.
Eingabe-Schema
{
"type": "object",
"properties": {
"start": {
"description": "Range start, ISO 8601 (for example 2026-11-01T00:00:00Z). Optional; send with end.",
"type": "string"
},
"end": {
"description": "Range end, ISO 8601. Optional; send with start. The range may not exceed 14 days.",
"type": "string"
},
"tracking_references": {
"description": "Tracking references. A shipment must contain all of them to match.",
"type": "array",
"items": {
"type": "string"
}
},
"custom_references": {
"description": "Your own custom references. A shipment must contain all of them to match.",
"type": "array",
"items": {
"type": "string"
}
},
"carrier": {
"description": "Carrier names to include.",
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sorted_get_shipment_events(shipment_id)
Get all tracking events recorded for one shipment, by shipment id. Track API: GET /events/search?shipment_id=.
Eingabe-Schema
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"minLength": 1,
"description": "Track shipment id, for example sp_… (from sorted_search_shipments)."
}
},
"required": [
"shipment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sorted_get_shipment_states(shipment_id)
Get the state history of one shipment (each state and when it was set), by shipment id. Track API: GET /events/shipment-states?shipment_id=.
Eingabe-Schema
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"minLength": 1,
"description": "Track shipment id, for example sp_… (from sorted_search_shipments)."
}
},
"required": [
"shipment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sorted_get_tracking_events(shipment_id)
Get the raw carrier tracking events for one shipment, by shipment id. Track API: GET /tracking/search?shipment_id=.
Eingabe-Schema
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"minLength": 1,
"description": "Track shipment id, for example sp_… (from sorted_search_shipments)."
}
},
"required": [
"shipment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴sorted_register_shipments(shipments)
Register one or more shipments in the customer's Track account so Track starts tracking them. Each shipment needs at least one tracking reference. Registering the same shipment twice creates a duplicate, so check first with sorted_search_shipments. Track API: POST /shipments.
Eingabe-Schema
{
"type": "object",
"properties": {
"shipments": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"tracking_references": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
},
"description": "Carrier tracking numbers. The first is the primary reference."
},
"unique_references": {
"description": "References that identify the shipment for duplicate detection (3 to 50 characters each).",
"type": "array",
"items": {
"type": "object",
"properties": {
"reference": {
"type": "string",
"minLength": 3,
"maxLength": 50
}
},
"required": [
"reference"
],
"additionalProperties": {}
}
},
"custom_references": {
"description": "Your own order or customer references.",
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"carrier": {
"description": "Carrier name.",
"type": "string"
},
"carrier_service": {
"type": "string"
},
"shipped_date": {
"description": "YYYY-MM-DDThh:mm:ss+hh:mm.",
"type": "string"
},
"order_date": {
"description": "YYYY-MM-DDThh:mm:ss+hh:mm.",
"type": "string"
},
"promised_date": {
"description": "Promised delivery window.",
"type": "object",
"properties": {
"start": {
"description": "ISO 8601 timestamp.",
"type": "string"
},
"end": {
"description": "ISO 8601 timestamp.",
"type": "string"
}
},
"additionalProperties": {}
},
"expected_delivery_date": {
"description": "Expected delivery window.",
"type": "object",
"properties": {
"start": {
"description": "ISO 8601 timestamp.",
"type": "string"
},
"end": {
"description": "ISO 8601 timestamp.",
"type": "string"
}
},
"additionalProperties": {}
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address_type": {
"type": "string",
"enum": [
"not_specified",
"origin",
"destination",
"return",
"billing",
"hub",
"alternative_delivery",
"other"
]
},
"reference": {
"type": "string"
},
"address_line1": {
"type": "string"
},
"locality": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"country_iso_code": {
"description": "ISO 3166-1 alpha-2 code, for example GB.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"consumer": {
"type": "object",
"properties": {
"reference": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
}
},
"additionalProperties": {}
},
"metadata": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"type": {
"type": "string",
"description": "Value type, for example string, boolean, integer, decimal or date_time."
}
},
"required": [
"key",
"value",
"type"
],
"additionalProperties": {}
}
},
"retailer": {
"type": "string"
},
"shipment_type": {
"type": "string"
}
},
"required": [
"tracking_references"
],
"additionalProperties": {}
},
"description": "Shipments to register, 1 to 100 per call. Split larger lists into several calls."
}
},
"required": [
"shipments"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴sorted_update_shipment(shipment_id, tracking_references, unique_references, custom_references, tags, ...)
Update one registered shipment. Send the full shipment record with the registration fields; the update uses the same fields as registration. Track API: PUT /shipments/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"minLength": 1,
"description": "Track shipment id, for example sp_… (from sorted_search_shipments)."
},
"tracking_references": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
},
"description": "Carrier tracking numbers. The first is the primary reference."
},
"unique_references": {
"description": "References that identify the shipment for duplicate detection (3 to 50 characters each).",
"type": "array",
"items": {
"type": "object",
"properties": {
"reference": {
"type": "string",
"minLength": 3,
"maxLength": 50
}
},
"required": [
"reference"
],
"additionalProperties": {}
}
},
"custom_references": {
"description": "Your own order or customer references.",
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"carrier": {
"description": "Carrier name.",
"type": "string"
},
"carrier_service": {
"type": "string"
},
"shipped_date": {
"description": "YYYY-MM-DDThh:mm:ss+hh:mm.",
"type": "string"
},
"order_date": {
"description": "YYYY-MM-DDThh:mm:ss+hh:mm.",
"type": "string"
},
"promised_date": {
"description": "Promised delivery window.",
"type": "object",
"properties": {
"start": {
"description": "ISO 8601 timestamp.",
"type": "string"
},
"end": {
"description": "ISO 8601 timestamp.",
"type": "string"
}
},
"additionalProperties": {}
},
"expected_delivery_date": {
"description": "Expected delivery window.",
"type": "object",
"properties": {
"start": {
"description": "ISO 8601 timestamp.",
"type": "string"
},
"end": {
"description": "ISO 8601 timestamp.",
"type": "string"
}
},
"additionalProperties": {}
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address_type": {
"type": "string",
"enum": [
"not_specified",
"origin",
"destination",
"return",
"billing",
"hub",
"alternative_delivery",
"other"
]
},
"reference": {
"type": "string"
},
"address_line1": {
"type": "string"
},
"locality": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"country_iso_code": {
"description": "ISO 3166-1 alpha-2 code, for example GB.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"consumer": {
"type": "object",
"properties": {
"reference": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
}
},
"additionalProperties": {}
},
"metadata": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"type": {
"type": "string",
"description": "Value type, for example string, boolean, integer, decimal or date_time."
}
},
"required": [
"key",
"value",
"type"
],
"additionalProperties": {}
}
},
"retailer": {
"type": "string"
},
"shipment_type": {
"type": "string"
}
},
"required": [
"shipment_id",
"tracking_references"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis