Avito MCP

Overview Schema Source Related Servers Discussions Admin

⚠️ Delivery: create parcel [3PL]

delivery_create_parcel

Create a production parcel on the delivery service for an Avito order, supplying items, sender, receiver, and payment. Intended for 3PL partners; regular seller accounts are not authorized.

Instructions

[3PL] Production creation of a parcel on the delivery-service side (CreateParcelRequest). The method is implemented by the delivery-service partner — on a regular seller account it returns 403/404. orderID, parcelID, items, sender, receiver, payment are required. Unlike delivery_create_sandbox_parcel_v2 ([SANDBOX v2]), this is production, the creation of a real parcel.

Input Schema

TableJSON Schema

Name	Required	Description
`items`	Yes	Parcel contents (items); at least one element.
`dryRun`	No	v0.7.0: if true — returns a preview of the HTTP request without calling the Avito API. Safe for inspecting exactly what would be done. Default: the value of AVITO_MCP_DRY_RUN_DEFAULT (usually false).
`sender`	Yes	Sender and delivery point.
`options`	No	Return and parcel-tag options (optional).
`orderID`	Yes	Avito order identifier.
`package`	No	Packaging dimensions and weight (optional).
`payment`	Yes	Payment parameters for items and delivery.
`barcodes`	No	Parcel barcodes (optional).
`parcelID`	Yes	Parcel identifier on the delivery-service side.
`receiver`	Yes	Receiver and delivery point.
`directOrderID`	No	Direct order identifier at the delivery service (optional).
`idempotencyKey`	No	v0.7.0: optional key for duplicate protection. A repeat call with the same key within AVITO_MCP_IDEMPOTENCY_TTL_SEC returns the cached result. The same key with different args returns a conflict error. Keys are stored as bounded SHA-256 fingerprints.

Schema Changelog

Changes observed during successful MCP inspections.

Addedv1.3.3Jul 29, 2026
Removedv1.3.2Jul 17, 2026

Changed30 schema fields changedv1.2.0Jul 10, 2026

changedInput schema / properties / idempotencyKey / description

Previous value: -"v0.7.0: optional key for duplicate protection. A repeat call with the same key within AVITO_MCP_IDEMPOTENCY_TTL_SEC returns the cached result. The same key with different args returns a conflict error — this is safe by design."New value: +"v0.7.0: optional key for duplicate protection. A repeat call with the same key within AVITO_MCP_IDEMPOTENCY_TTL_SEC returns the cached result. The same key with different args returns a conflict error. Keys are stored as bounded SHA-256 fingerprints."

removedInput schema / properties / items / items / additionalProperties
```
Removed value: -{}
```

removedInput schema / properties / items / items / description

Removed value: -"See CreateParcelItem in swaggers/delivery.json"

addedInput schema / properties / items / items / properties

Added value: +{
+  "breadcrumbs": {
+    "items": {
+      "properties": {
+        "name": {
+          "maxLength": 255,
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "cost": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "description": {
+    "maxLength": 1000,
+    "type": "string"
+  },
+  "dimensions": {
+    "properties": {
+      "accuracy": {
+        "enum": [
+          "EXACT",
+          "APPROXIMATE"
+        ],
+        "type": "string"
+      },
+      "values": {
+        "items": {
+          "maximum": 200,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "maxItems": 3,
+        "minItems": 3,
+        "type": "array"
+      }
+    },
+    "required": [
+      "accuracy",
+      "values"
+    ],
+    "type": "object"
+  },
+  "id": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "imagesUrls": {
+    "properties": {
+      "list": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "listing": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "list",
+      "listing"
+    ],
+    "type": "object"
+  },
+  "quantity": {
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "tags": {
+    "items": {
+      "const": "TRY_ON",
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "title": {
+    "maxLength": 100,
+    "type": "string"
+  },
+  "weight": {
+    "properties": {
+      "accuracy": {
+        "enum": [
+          "EXACT",
+          "APPROXIMATE"
+        ],
+        "type": "string"
+      },
+      "value": {
+        "maximum": 50000,
+        "minimum": 1,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "accuracy",
+      "value"
+    ],
+    "type": "object"
+  }
+}

removedInput schema / properties / items / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

addedInput schema / properties / items / items / required

Added value: +[
+  "cost",
+  "id",
+  "quantity",
+  "title"
+]

removedInput schema / properties / options / additionalProperties
```
Removed value: -{}
```

changedInput schema / properties / options / description

Previous value: -"Additional parcel options (optional)."New value: +"Return and parcel-tag options (optional)."

addedInput schema / properties / options / properties

Added value: +{
+  "return": {
+    "properties": {
+      "receiver": {
+        "properties": {
+          "delivery": {
+            "properties": {
+              "completenessAndIntegrity": {
+                "items": {
+                  "enum": [
+                    "DIRECT_FLOW",
+                    "RETURN_FLOW"
+                  ],
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "courier": {
+                "properties": {
+                  "address": {
+                    "properties": {
+                      "addressRow": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "coordinates": {
+                        "properties": {
+                          "latitude": {
+                            "maximum": 90,
+                            "minimum": -90,
+                            "type": "number"
+                          },
+                          "longitude": {
+                            "maximum": 180,
+                            "minimum": -180,
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "latitude",
+                          "longitude"
+                        ],
+                        "type": "object"
+                      },
+                      "details": {
+                        "properties": {
+                          "flat": {
+                            "type": "string"
+                          },
+                          "floor": {
+                            "type": "string"
+                          },
+                          "house": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "porch": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "house"
+                        ],
+                        "type": "object"
+                      }
+                    },
+                    "required": [
+                      "addressRow",
+                      "coordinates",
+                      "details"
+                    ],
+                    "type": "object"
+                  },
+                  "dateTimeInterval": {
+                    "properties": {
+                      "end": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "start": {
+                        "minLength": 1,
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "end",
+                      "start"
+                    ],
+                    "type": "object"
+                  },
+                  "options": {
+                    "properties": {
+                      "comment": {
+                        "type": "string"
+                      },
+                      "deliveryConfirmationType": {
+                        "const": "PHONE",
+                        "type": "string"
+                      },
+                      "deliveryType": {
+                        "enum": [
+                          "DELIVERY_TO_DOOR",
+                          "DELIVERY_TO_PORCH"
+                        ],
+                        "type": "string"
+                      },
+                      "elevatorAvailable": {
+                        "type": "boolean"
+                      }
+                    },
+                    "required": [
+                      "deliveryConfirmationType",
+                      "deliveryType",
+                      "elevatorAvailable"
+                    ],
+                    "type": "object"
+                  },
+                  "provider": {
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "address",
+                  "dateTimeInterval",
+                  "provider"
+                ],
+                "type": "object"
+              },
+              "secondPartyLogist": {
+                "properties": {
+                  "provider": {
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "provider"
+                ],
+                "type": "object"
+              },
+              "sortingCenter": {
+                "properties": {
+                  "accuracy": {
+                    "enum": [
+                      "EXACT",
+                      "APPROXIMATE"
+                    ],
+                    "type": "string"
+                  },
+                  "id": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "provider": {
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "accuracy",
+                  "id",
+                  "provider"
+                ],
+                "type": "object"
+              },
+              "terminal": {
+                "properties": {
+                  "accuracy": {
+                    "enum": [
+                      "EXACT",
+                      "APPROXIMATE"
+                    ],
+                    "type": "string"
+                  },
+                  "id": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "provider": {
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "accuracy",
+                  "id",
+                  "provider"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "enum": [
+                  "TERMINAL",
+                  "SORTING_CENTER",
+                  "COURIER"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          },
+          "email": {
+            "format": "email",
+            "maxLength": 320,
+            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
+            "type": "string"
+          },
+          "inn": {
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 255,
+            "type": "string"
+          },
+          "phones": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "type": {
+            "enum": [
+              "PRIVATE",
+              "LEGAL",
+              "3PL"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "delivery",
+          "email",
+          "name",
+          "phones",
+          "type"
+        ],
+        "type": "object"
+      },
+      "refused": {
+        "properties": {
+          "action": {
+            "enum": [
+              "DISABLED",
+              "DESTROY",
+              "RETURN_TO_DEPARTURE_POINT",
+              "RETURN_TO_RECEIVER",
+              "MOVE_TO_ON_DEMAND_STORAGE"
+            ],
+            "type": "string"
+          },
+          "after": {
+            "properties": {
+              "unit": {
+                "const": "DAY",
+                "type": "string"
+              },
+              "value": {
+                "maximum": 9007199254740991,
+                "minimum": 1,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "unit",
+              "value"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "type": "object"
+      },
+      "returned": {
+        "properties": {
+          "action": {
+            "enum": [
+              "DISABLED",
+              "DESTROY",
+              "RETURN_TO_DEPARTURE_POINT",
+              "RETURN_TO_RECEIVER",
+              "MOVE_TO_ON_DEMAND_STORAGE"
+            ],
+            "type": "string"
+          },
+          "after": {
+            "properties": {
+              "unit": {
+                "const": "DAY",
+                "type": "string"
+              },
+              "value": {
+                "maximum": 9007199254740991,
+                "minimum": 1,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "unit",
+              "value"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "type": "object"
+      },
+      "unclaimed": {
+        "properties": {
+          "action": {
+            "enum": [
+              "DISABLED",
+              "DESTROY",
+              "RETURN_TO_DEPARTURE_POINT",
+              "RETURN_TO_RECEIVER",
+              "MOVE_TO_ON_DEMAND_STORAGE"
+            ],
+            "type": "string"
+          },
+          "after": {
+            "properties": {
+              "unit": {
+                "const": "DAY",
+                "type": "string"
+              },
+              "value": {
+                "maximum": 9007199254740991,
+                "minimum": 1,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "unit",
+              "value"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "tags": {
+    "items": {
+      "enum": [
+        "C2C",
+        "B2C",
+        "X_DELIVERY",
+        "X_DELIVERY_FIRST_LEG",
+        "X_DELIVERY_LAST_LEG",
+        "RETURN"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  }
+}

removedInput schema / properties / options / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / package / additionalProperties
```
Removed value: -{}
```

changedInput schema / properties / package / description

Previous value: -"Packaging parameters: dimensions, weight (optional)."New value: +"Packaging dimensions and weight (optional)."

addedInput schema / properties / package / properties

Added value: +{
+  "dimensions": {
+    "properties": {
+      "accuracy": {
+        "enum": [
+          "EXACT",
+          "APPROXIMATE"
+        ],
+        "type": "string"
+      },
+      "values": {
+        "items": {
+          "maximum": 200,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "maxItems": 3,
+        "minItems": 3,
+        "type": "array"
+      }
+    },
+    "required": [
+      "accuracy",
+      "values"
+    ],
+    "type": "object"
+  },
+  "weight": {
+    "properties": {
+      "accuracy": {
+        "enum": [
+          "EXACT",
+          "APPROXIMATE"
+        ],
+        "type": "string"
+      },
+      "value": {
+        "maximum": 50000,
+        "minimum": 1,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "accuracy",
+      "value"
+    ],
+    "type": "object"
+  }
+}

removedInput schema / properties / package / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / package / required
```
Added value: +[
+  "dimensions",
+  "weight"
+]
```
removedInput schema / properties / payment / additionalProperties
```
Removed value: -{}
```

changedInput schema / properties / payment / description

Previous value: -"Payment parameters: method, amount, declared value."New value: +"Payment parameters for items and delivery."

addedInput schema / properties / payment / properties

Added value: +{
+  "delivery": {
+    "properties": {
+      "costWithoutVat": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "status": {
+        "enum": [
+          "PAID",
+          "ON_DELIVERY"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "costWithoutVat",
+      "status"
+    ],
+    "type": "object"
+  },
+  "items": {
+    "properties": {
+      "cost": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "status": {
+        "enum": [
+          "PAID",
+          "ON_DELIVERY"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "cost",
+      "status"
+    ],
+    "type": "object"
+  }
+}

removedInput schema / properties / payment / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / payment / required
```
Added value: +[
+  "delivery",
+  "items"
+]
```
removedInput schema / properties / receiver / additionalProperties
```
Removed value: -{}
```

changedInput schema / properties / receiver / description

Previous value: -"Receiver: full name, phone, address or pickup-point code."New value: +"Receiver and delivery point."

addedInput schema / properties / receiver / properties

Added value: +{
+  "delivery": {
+    "properties": {
+      "completenessAndIntegrity": {
+        "items": {
+          "enum": [
+            "DIRECT_FLOW",
+            "RETURN_FLOW"
+          ],
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "courier": {
+        "properties": {
+          "address": {
+            "properties": {
+              "addressRow": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "coordinates": {
+                "properties": {
+                  "latitude": {
+                    "maximum": 90,
+                    "minimum": -90,
+                    "type": "number"
+                  },
+                  "longitude": {
+                    "maximum": 180,
+                    "minimum": -180,
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "latitude",
+                  "longitude"
+                ],
+                "type": "object"
+              },
+              "details": {
+                "properties": {
+                  "flat": {
+                    "type": "string"
+                  },
+                  "floor": {
+                    "type": "string"
+                  },
+                  "house": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "porch": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "house"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "addressRow",
+              "coordinates",
+              "details"
+            ],
+            "type": "object"
+          },
+          "dateTimeInterval": {
+            "properties": {
+              "end": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "start": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "end",
+              "start"
+            ],
+            "type": "object"
+          },
+          "options": {
+            "properties": {
+              "comment": {
+                "type": "string"
+              },
+              "deliveryConfirmationType": {
+                "const": "PHONE",
+                "type": "string"
+              },
+              "deliveryType": {
+                "enum": [
+                  "DELIVERY_TO_DOOR",
+                  "DELIVERY_TO_PORCH"
+                ],
+                "type": "string"
+              },
+              "elevatorAvailable": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "deliveryConfirmationType",
+              "deliveryType",
+              "elevatorAvailable"
+            ],
+            "type": "object"
+          },
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "address",
+          "dateTimeInterval",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "secondPartyLogist": {
+        "properties": {
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "provider"
+        ],
+        "type": "object"
+      },
+      "sortingCenter": {
+        "properties": {
+          "accuracy": {
+            "enum": [
+              "EXACT",
+              "APPROXIMATE"
+            ],
+            "type": "string"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "accuracy",
+          "id",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "terminal": {
+        "properties": {
+          "accuracy": {
+            "enum": [
+              "EXACT",
+              "APPROXIMATE"
+            ],
+            "type": "string"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "accuracy",
+          "id",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "enum": [
+          "TERMINAL",
+          "SORTING_CENTER",
+          "COURIER"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  "email": {
+    "format": "email",
+    "maxLength": 320,
+    "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
+    "type": "string"
+  },
+  "inn": {
+    "type": "string"
+  },
+  "name": {
+    "maxLength": 255,
+    "type": "string"
+  },
+  "phones": {
+    "items": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "type": {
+    "enum": [
+      "PRIVATE",
+      "LEGAL",
+      "3PL"
+    ],
+    "type": "string"
+  }
+}

removedInput schema / properties / receiver / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

addedInput schema / properties / receiver / required

Added value: +[
+  "delivery",
+  "email",
+  "name",
+  "phones",
+  "type"
+]

removedInput schema / properties / sender / additionalProperties
```
Removed value: -{}
```

changedInput schema / properties / sender / description

Previous value: -"Sender: full name/company name, phone, address/sending node."New value: +"Sender and delivery point."

addedInput schema / properties / sender / properties

Added value: +{
+  "delivery": {
+    "properties": {
+      "completenessAndIntegrity": {
+        "items": {
+          "enum": [
+            "DIRECT_FLOW",
+            "RETURN_FLOW"
+          ],
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "courier": {
+        "properties": {
+          "address": {
+            "properties": {
+              "addressRow": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "coordinates": {
+                "properties": {
+                  "latitude": {
+                    "maximum": 90,
+                    "minimum": -90,
+                    "type": "number"
+                  },
+                  "longitude": {
+                    "maximum": 180,
+                    "minimum": -180,
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "latitude",
+                  "longitude"
+                ],
+                "type": "object"
+              },
+              "details": {
+                "properties": {
+                  "flat": {
+                    "type": "string"
+                  },
+                  "floor": {
+                    "type": "string"
+                  },
+                  "house": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "porch": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "house"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "addressRow",
+              "coordinates",
+              "details"
+            ],
+            "type": "object"
+          },
+          "dateTimeInterval": {
+            "properties": {
+              "end": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "start": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "end",
+              "start"
+            ],
+            "type": "object"
+          },
+          "options": {
+            "properties": {
+              "comment": {
+                "type": "string"
+              },
+              "deliveryConfirmationType": {
+                "const": "PHONE",
+                "type": "string"
+              },
+              "deliveryType": {
+                "enum": [
+                  "DELIVERY_TO_DOOR",
+                  "DELIVERY_TO_PORCH"
+                ],
+                "type": "string"
+              },
+              "elevatorAvailable": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "deliveryConfirmationType",
+              "deliveryType",
+              "elevatorAvailable"
+            ],
+            "type": "object"
+          },
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "address",
+          "dateTimeInterval",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "secondPartyLogist": {
+        "properties": {
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "provider"
+        ],
+        "type": "object"
+      },
+      "sortingCenter": {
+        "properties": {
+          "accuracy": {
+            "enum": [
+              "EXACT",
+              "APPROXIMATE"
+            ],
+            "type": "string"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "accuracy",
+          "id",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "terminal": {
+        "properties": {
+          "accuracy": {
+            "enum": [
+              "EXACT",
+              "APPROXIMATE"
+            ],
+            "type": "string"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "provider": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "accuracy",
+          "id",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "enum": [
+          "TERMINAL",
+          "SORTING_CENTER",
+          "COURIER"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  "email": {
+    "format": "email",
+    "maxLength": 320,
+    "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
+    "type": "string"
+  },
+  "inn": {
+    "type": "string"
+  },
+  "name": {
+    "maxLength": 255,
+    "type": "string"
+  },
+  "phones": {
+    "items": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "type": {
+    "enum": [
+      "PRIVATE",
+      "LEGAL",
+      "3PL"
+    ],
+    "type": "string"
+  }
+}

removedInput schema / properties / sender / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

addedInput schema / properties / sender / required

Added value: +[
+  "delivery",
+  "email",
+  "name",
+  "phones",
+  "type"
+]

Changed1 schema field changedv0.8.1Jun 17, 2026

changedInput schema / properties / items / items / description

Previous value: -"See CreateParcelItem in swaggers/Доставка.json"New value: +"See CreateParcelItem in swaggers/delivery.json"

Changed13 schema fields changedv0.8.0May 31, 2026

changedInput schema / properties / barcodes / description

Previous value: -"Штрихкоды посылки (опционально)."New value: +"Parcel barcodes (optional)."

changedInput schema / properties / directOrderID / description

Previous value: -"Прямой идентификатор заказа (опционально)."New value: +"Direct order identifier at the delivery service (optional)."

changedInput schema / properties / dryRun / description

Previous value: -"v0.7.0: если true — возвращает preview HTTP-запроса без вызова Avito API. Безопасно для просмотра, что именно будет сделано. Default: значение AVITO_MCP_DRY_RUN_DEFAULT (обычно false)."New value: +"v0.7.0: if true — returns a preview of the HTTP request without calling the Avito API. Safe for inspecting exactly what would be done. Default: the value of AVITO_MCP_DRY_RUN_DEFAULT (usually false)."

changedInput schema / properties / idempotencyKey / description

Previous value: -"v0.7.0: опциональный ключ для защиты от дублей. Повторный вызов с тем же ключом в течение AVITO_MCP_IDEMPOTENCY_TTL_SEC возвращает закешированный результат. Тот же ключ с другими args вернёт ошибку conflict — это безопасно по дизайну."New value: +"v0.7.0: optional key for duplicate protection. A repeat call with the same key within AVITO_MCP_IDEMPOTENCY_TTL_SEC returns the cached result. The same key with different args returns a conflict error — this is safe by design."

changedInput schema / properties / items / description

Previous value: -"Состав посылки (товары)."New value: +"Parcel contents (items); at least one element."

changedInput schema / properties / items / items / description

Previous value: -"См. CreateParcelItem в swaggers/Доставка.json"New value: +"See CreateParcelItem in swaggers/Доставка.json"

changedInput schema / properties / options / description

Previous value: -"Доп. опции (опционально)."New value: +"Additional parcel options (optional)."

changedInput schema / properties / orderID / description

Previous value: -"Идентификатор заказа."New value: +"Avito order identifier."

changedInput schema / properties / package / description

Previous value: -"Параметры упаковки (опционально)."New value: +"Packaging parameters: dimensions, weight (optional)."

changedInput schema / properties / parcelID / description

Previous value: -"Идентификатор посылки."New value: +"Parcel identifier on the delivery-service side."

changedInput schema / properties / payment / description

Previous value: -"Параметры оплаты."New value: +"Payment parameters: method, amount, declared value."

changedInput schema / properties / receiver / description

Previous value: -"Получатель."New value: +"Receiver: full name, phone, address or pickup-point code."

changedInput schema / properties / sender / description

Previous value: -"Отправитель."New value: +"Sender: full name/company name, phone, address/sending node."

First observedv0.7.4May 28, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are basic (readOnlyHint false, etc.). The description adds valuable context: it is a real parcel creation, and regular accounts get 403/404. This goes beyond annotations without contradicting them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with two sentences that front-load the key purpose and then provide usage context. Every sentence earns its place with no fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has complex nested parameters, but schema descriptions are thorough. The description does not explain return values (no output schema) or provide behavioral details beyond basic permissions. Adequate but could be more complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description lists required parameters by name but adds little beyond the schema, only noting version stamps on dryRun and idempotencyKey.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool creates a parcel in production, with a specific verb and resource. It distinguishes itself from the sandbox sibling (delivery_create_sandbox_parcel_v2) by noting it is 'production, the creation of a real parcel.'

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly indicates this is for production use, not for regular seller accounts (which get 403/404), implying 3PL accounts. It lists required parameters and contrasts with the sandbox version, providing clear when-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

⚠️ Delivery: create parcel [3PL]

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools