MyParcel MCP by usefulapi
Create, read and delete shipments; read track and trace and pickup points in MyParcel.
使うべきか
品質と安全性
検出事項(2)
- LOWmyparcel_list_fulfilment_orders 内
- LOWmyparcel_list_webhook_subscriptions 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"myparcel": {
"url": "https://myparcel.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://myparcel.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(10)
🟢myparcel_list_shipments(q, status, page, size)
List the account's shipments, newest first, with status, recipient and carrier. Filter by a text query or a status id. MyParcel API: GET /shipments.
入力スキーマ
{
"type": "object",
"properties": {
"q": {
"description": "Search text (for example a recipient name).",
"type": "string"
},
"status": {
"description": "Shipment status id (for example 1 = pending).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_get_shipments(ids)
Get one or more shipments by id, including options, recipient, status and label links. MyParcel API: GET /shipments/{ids}.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Shipment ids from myparcel_list_shipments or myparcel_create_shipments."
}
},
"required": [
"ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_get_tracktraces(ids, extra_info)
Get the track and trace events for one or more shipments (carrier scan history and status). MyParcel API: GET /tracktraces/{ids}.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Shipment ids from myparcel_list_shipments or myparcel_create_shipments."
},
"extra_info": {
"description": "Optional extra data, for example delivery_moment.",
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_list_fulfilment_orders(status)
List fulfilment orders (orders the account asked MyParcel to pick and ship), filtered by status. MyParcel API: GET /fulfilment/orders.
入力スキーマ
{
"type": "object",
"properties": {
"status": {
"description": "Status filter, separated by ';' (for example open;partially_processed).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_get_fulfilment_order(identifier)
Get one fulfilment order by its UUID, including its lines and status. MyParcel API: GET /fulfilment/orders/{identifier}.
入力スキーマ
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"minLength": 1,
"description": "Fulfilment order UUID (from myparcel_list_fulfilment_orders)."
}
},
"required": [
"identifier"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_get_delivery_options(platform, carrier, cc, number, postal_code)
Get the delivery options (dates, delivery types, cut-off times) for one address and carrier, for a checkout. MyParcel API: GET /delivery_options (version 2.0).
入力スキーマ
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"myparcel",
"belgie"
],
"description": "myparcel for NL, belgie for BE."
},
"carrier": {
"type": "string",
"minLength": 1,
"description": "Carrier name, for example postnl or bpost."
},
"cc": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO country code, e.g. nl or be."
},
"number": {
"type": "string",
"minLength": 1,
"description": "House number."
},
"postal_code": {
"type": "string",
"minLength": 1
}
},
"required": [
"platform",
"carrier",
"cc",
"number",
"postal_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_list_pickup_locations(platform, carrier, cc, number, postal_code)
List pickup points near one address for a carrier (for pickup delivery types). MyParcel API: GET /pickup_locations.
入力スキーマ
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"myparcel",
"belgie"
],
"description": "myparcel for NL, belgie for BE."
},
"carrier": {
"type": "string",
"minLength": 1,
"description": "Carrier name, for example postnl or bpost."
},
"cc": {
"type": "string",
"minLength": 2,
"maxLength": 2
},
"number": {
"type": "string",
"minLength": 1
},
"postal_code": {
"type": "string",
"minLength": 1
}
},
"required": [
"platform",
"carrier",
"cc",
"number",
"postal_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢myparcel_list_webhook_subscriptions
List the webhook subscriptions on the account (the URLs MyParcel calls on shipment events). MyParcel API: GET /webhook_subscriptions.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴myparcel_create_shipments(shipments)
Create one or more shipments. This creates real, billable shipments and labels on the account. Returns the new shipment ids in the same order as sent. MyParcel API: POST /shipments.
入力スキーマ
{
"type": "object",
"properties": {
"shipments": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"reference_identifier": {
"description": "Your own reference for this shipment.",
"type": "string"
},
"carrier": {
"description": "Carrier id from the MyParcel API (1 = PostNL in the docs example).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"recipient": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO country code, e.g. NL or BE."
},
"city": {
"type": "string",
"minLength": 1
},
"street": {
"type": "string",
"minLength": 1
},
"number": {
"type": "string",
"minLength": 1,
"description": "House number, as text."
},
"postal_code": {
"type": "string",
"minLength": 1
},
"person": {
"description": "Recipient name.",
"type": "string"
},
"company": {
"type": "string"
},
"region": {
"type": "string"
},
"phone": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"cc",
"city",
"street",
"number",
"postal_code"
]
},
"options": {
"type": "object",
"properties": {
"package_type": {
"description": "1 = package, 2 = mailbox package, 3 = letter, 4 = digital stamp.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"delivery_type": {
"description": "Delivery type id (see the delivery options docs).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"only_recipient": {
"description": "1 = deliver to the recipient only.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"signature": {
"description": "1 = signature on delivery.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"return": {
"description": "1 = return label on the shipment.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"large_format": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"label_description": {
"type": "string"
},
"insurance": {
"description": "Amount in cents.",
"type": "object",
"properties": {
"amount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"minLength": 3,
"maxLength": 3
}
},
"required": [
"amount",
"currency"
]
}
},
"additionalProperties": {},
"description": "Shipment options, as in the MyParcel options object. Extra keys pass through."
}
},
"required": [
"recipient",
"options"
]
},
"description": "Shipments to create; each needs a recipient and options."
}
},
"required": [
"shipments"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴myparcel_delete_shipments(ids)
Delete one or more shipments by id. A shipment that has already been handed to the carrier may not be deletable. MyParcel API: DELETE /shipments/{ids}.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Shipment ids from myparcel_list_shipments or myparcel_create_shipments."
}
},
"required": [
"ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス