Sorted MCP by usefulapi

Register, update and search shipments; read tracking events and states in Sorted.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
96%
이름 품질
100%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,455토큰 (도구 정의)
~2.6 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.92%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 9개