Sorted MCP by usefulapi
Register, update and search shipments; read tracking events and states in Sorted.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"sorted": {
"url": "https://sorted.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://sorted.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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=.
입력 스키마
{
"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=.
입력 스키마
{
"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=.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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"
}커뮤니티
증거