Boxtal MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
96%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~1,970Tokens (Tool-Definitionen)
~2.5 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (1.54% von 128k Kontext)

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": {
    "boxtal": {
      "url": "https://boxtal.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (7)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

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

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet7 Tools