Boxtal MCP by usefulapi

Find parcel points, create and cancel shipping orders, read tracking and documents in Boxtal.

사용해야 할까요

품질 및 안전성

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

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

컨텍스트 비용

~1,970토큰 (도구 정의)
~2.5 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.54%)

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

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "boxtal": {
      "url": "https://boxtal.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://boxtal.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (7)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢boxtal_list_content_categories(language)

List the Boxtal content categories (what a parcel contains) that a shipping order accepts. Boxtal API: GET /v3.1/content-category.

입력 스키마

{
  "type": "object",
  "properties": {
    "language": {
      "description": "Language of the labels, for example fr or en.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢boxtal_find_parcel_points(countryIsoCode, number, street, city, postalCode, ...)

Find parcel pickup and drop-off points (relay points, lockers) near an address, optionally for chosen networks. Boxtal API: GET /v3.1/parcel-point.

입력 스키마

{
  "type": "object",
  "properties": {
    "countryIsoCode": {
      "type": "string",
      "description": "Two-letter ISO country code of the reference location, for example FR."
    },
    "number": {
      "description": "House number of the reference location.",
      "type": "string"
    },
    "street": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "postalCode": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "searchNetworks": {
      "description": "Networks to search, for example MONR (Mondial Relay) or UPSE (UPS). Omit for all.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "countryIsoCode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢boxtal_get_shipping_order(id)

Get one Boxtal shipping order: its status (PENDING, REQUESTED, CONFIRMED or CANCELLED), dates and prices. Boxtal API: GET /v3.1/shipping-order/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Boxtal shipping order id (shippingOrder.id returned when the order was created)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢boxtal_get_tracking(id)

Get the tracking history of the packages in a shipping order (status, events, tracking number). Boxtal API: GET /v3.1/shipping-order/{id}/tracking.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Boxtal shipping order id (shippingOrder.id returned when the order was created)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢boxtal_get_shipping_documents(id)

Get the shipping documents of an order (label, proforma, CN23, voucher) with their download URLs. Boxtal API: GET /v3.1/shipping-order/{id}/shipping-document.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Boxtal shipping order id (shippingOrder.id returned when the order was created)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴boxtal_create_shipping_order(shippingOfferCode, shippingOfferId, insured, labelType, expectedTakingOverDate, ...)

WRITE: creates AND ORDERS a real shipment on the customer's Boxtal account, which is billed to that account. Use it only when the user asks to ship that parcel. The account must have deferred payment (paiement différé) enabled; otherwise Boxtal returns an error with its reason. Choose the carrier with shippingOfferCode (see the Boxtal offer code list) or shippingOfferId (a hosted contract offer). Boxtal API: POST /v3.1/shipping-order.

입력 스키마

{
  "type": "object",
  "properties": {
    "shippingOfferCode": {
      "description": "Transport offer code, for example CHRP-Chrono13 or UPSE-Standard. Give this or shippingOfferId.",
      "type": "string"
    },
    "shippingOfferId": {
      "description": "Id of an offer from a hosted contract. Give this or shippingOfferCode.",
      "type": "string"
    },
    "insured": {
      "description": "Add insurance to the shipment.",
      "type": "boolean"
    },
    "labelType": {
      "description": "Label format.",
      "type": "string",
      "enum": [
        "PDF_A4",
        "PDF_10x15"
      ]
    },
    "expectedTakingOverDate": {
      "description": "Date the carrier should collect the parcel, yyyy-mm-dd.",
      "type": "string"
    },
    "shipment": {
      "type": "object",
      "properties": {
        "externalId": {
          "type": "string"
        },
        "fromAddress": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "RESIDENTIAL",
                "BUSINESS"
              ]
            },
            "contact": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "phone": {
                  "type": "string"
                },
                "company": {
                  "type": "string"
                }
              },
              "required": [
                "firstName",
                "lastName",
                "email",
                "phone"
              ]
            },
            "location": {
              "type": "object",
              "properties": {
                "street": {
                  "type": "string",
                  "description": "Street name and line."
                },
                "number": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "postalCode": {
                  "type": "string"
                },
                "countryIsoCode": {
                  "description": "Two-letter ISO country code, for example FR.",
                  "type": "string"
                }
              },
              "required": [
                "street",
                "city"
              ]
            },
            "additionalInformation": {
              "type": "string"
            }
          },
          "required": [
            "type",
            "contact",
            "location"
          ]
        },
        "toAddress": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "RESIDENTIAL",
                "BUSINESS"
              ]
            },
            "contact": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "phone": {
                  "type": "string"
                },
                "company": {
                  "type": "string"
                }
              },
              "required": [
                "firstName",
                "lastName",
                "email",
                "phone"
              ]
            },
            "location": {
              "type": "object",
              "properties": {
                "street": {
                  "type": "string",
                  "description": "Street name and line."
                },
                "number": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "postalCode": {
                  "type": "string"
                },
                "countryIsoCode": {
                  "description": "Two-letter ISO country code, for example FR.",
                  "type": "string"
                }
              },
              "required": [
                "street",
                "city"
              ]
            },
            "additionalInformation": {
              "type": "string"
            }
          },
          "required": [
            "type",
            "contact",
            "location"
          ]
        },
        "packages": {
          "minItems": 1,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "PARCEL",
                  "LETTER",
                  "PALLET"
                ]
              },
              "value": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number",
                    "description": "Amount."
                  },
                  "currency": {
                    "type": "string",
                    "enum": [
                      "EUR"
                    ],
                    "description": "Currency. Only EUR."
                  }
                },
                "required": [
                  "value",
                  "currency"
                ],
                "description": "Declared value of the package."
              },
              "width": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "Width in cm."
              },
              "height": {
                "description": "Height in cm.",
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "length": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "Length in cm."
              },
              "weight": {
                "type": "number",
                "description": "Weight in kg."
              },
              "content": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "description"
                ]
              },
              "stackable": {
                "type": "boolean"
              },
              "externalId": {
                "type": "string"
              }
            },
            "required": [
              "value",
              "width",
              "length",
              "weight"
            ]
          }
        },
        "pickupPointCode": {
          "type": "string"
        },
        "dropoffPointCode": {
          "type": "string"
        },
        "customsDeclaration": {
          "description": "Needed for international shipments only.",
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "enum": [
                "SALE",
                "REPAIR",
                "RETURN",
                "GIFT",
                "SAMPLE",
                "DOCUMENTS",
                "PERSONAL_USE",
                "OTHER"
              ]
            },
            "articles": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "quantity": {
                    "type": "number"
                  },
                  "unitValue": {
                    "type": "object",
                    "properties": {
                      "value": {
                        "type": "number",
                        "description": "Amount."
                      },
                      "currency": {
                        "type": "string",
                        "enum": [
                          "EUR"
                        ],
                        "description": "Currency. Only EUR."
                      }
                    },
                    "required": [
                      "value",
                      "currency"
                    ]
                  },
                  "unitWeight": {
                    "type": "number"
                  },
                  "description": {
                    "type": "string"
                  },
                  "tariffNumber": {
                    "type": "string"
                  },
                  "originCountry": {
                    "type": "string",
                    "description": "Two-letter ISO code of the country of origin."
                  },
                  "packageExternalId": {
                    "type": "string"
                  }
                },
                "required": [
                  "quantity",
                  "unitValue",
                  "unitWeight",
                  "description",
                  "originCountry"
                ]
              }
            }
          }
        }
      },
      "required": [
        "fromAddress",
        "toAddress",
        "packages"
      ]
    }
  },
  "required": [
    "shipment"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴boxtal_cancel_shipping_order(id)

WRITE: cancels a shipping order on the customer's Boxtal account. The cancel can fail once the carrier has taken the parcel. Boxtal API: DELETE /v3.1/shipping-order/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Boxtal shipping order id (shippingOrder.id returned when the order was created)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

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