Avito MCP

by elchin92

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Delivery: upload tariff [sandbox]

delivery_add_tariff_sandbox_v2

Destructive

Upload a delivery tariff to control direction availability, delivery cost, and terms in the Avito sandbox.

Instructions

Creates or replaces a tariff. [SANDBOX v2] Uploads a tariff so the delivery service controls direction availability, delivery cost and terms. Returns 200 on accept. Limits: body up to 400MB, up to 1 million directions. For delivery-service PARTNERS only. Prefer this v2 over any v1 tariff endpoint. Pair with delivery_update_terms (term zones) and delivery_add_terminals_sandbox (pickup points) to complete the tariff.

Input Schema

TableJSON Schema

Name	Required	Description
`name`	Yes	Human-readable tariff name (for the UI).
`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).
`directions`	Yes	Directions: directionTagFrom→directionTagTo link, tariff zone, minTerm/maxTerm (business days).
`tariffType`	No	Tariff type (optional).
`termsZones`	Yes	Delivery-term zones: deliveryProviderZoneId, name, minTerm/maxTerm (business days).
`tariffZones`	Yes	Tariff zones: name, deliveryProviderTariffZoneId, items (per-service price calculation models).
`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.
`deliveryProviderTariffId`	Yes	Tariff identifier on the delivery-service side.

Schema Changelog

Changes observed during successful MCP inspections.

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

Changed16 schema fields changedv1.2.0Jul 10, 2026

removedInput schema / properties / directions / items / additionalProperties
```
Removed value: -{}
```
removedInput schema / properties / directions / items / description
```
Removed value: -"See Direction in swaggers/delivery.json"
```

addedInput schema / properties / directions / items / properties

Added value: +{
+  "providerDirectionId": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "tagFrom": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "tagTo": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "zones": {
+    "items": {
+      "properties": {
+        "tariffZoneId": {
+          "type": "string"
+        },
+        "termsZoneId": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "0",
+            "3",
+            "4",
+            "5",
+            "6",
+            "S-PUDO2S-PUDO",
+            "S-AREA2S-AREA",
+            "S-PUDO2S-AREA",
+            "S-PUDO-BTW-F-HUB",
+            "S-HUB-BTW-S-PUDO"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  }
+}

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

addedInput schema / properties / directions / items / required

Added value: +[
+  "providerDirectionId",
+  "tagFrom",
+  "tagTo",
+  "zones"
+]

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

addedInput schema / properties / tariffType / enum
```
Added value: +[
+  "MGT",
+  "KGT"
+]
```
removedInput schema / properties / tariffZones / items / additionalProperties
```
Removed value: -{}
```
removedInput schema / properties / tariffZones / items / description
```
Removed value: -"See TariffZone in swaggers/delivery.json"
```

addedInput schema / properties / tariffZones / items / properties

Added value: +{
+  "deliveryProviderZoneId": {
+    "type": "string"
+  },
+  "items": {
+    "items": {
+      "oneOf": [
+        {
+          "properties": {
+            "calculationMechanic": {
+              "const": "GAP_TO_COST",
+              "type": "string"
+            },
+            "chargeableParameter": {
+              "enum": [
+                "WEIGHT",
+                "DIMENSIONS",
+                "PAID_WEIGHT"
+              ],
+              "type": "string"
+            },
+            "serviceName": {
+              "enum": [
+                "DELIVERY",
+                "DELIVERY_B2C"
+              ],
+              "type": "string"
+            },
+            "values": {
+              "items": {
+                "properties": {
+                  "cost": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "dimensionalFactor": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "maxDimensions": {
+                    "items": {
+                      "maximum": 9007199254740991,
+                      "minimum": -9007199254740991,
+                      "type": "integer"
+                    },
+                    "type": "array"
+                  },
+                  "maxWeight": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "calculationMechanic",
+            "chargeableParameter",
+            "serviceName",
+            "values"
+          ],
+          "type": "object"
+        },
+        {
+          "properties": {
+            "calculationMechanic": {
+              "const": "WEIGHT_INTERVALS",
+              "type": "string"
+            },
+            "chargeableParameter": {
+              "const": "WEIGHT",
+              "type": "string"
+            },
+            "serviceName": {
+              "enum": [
+                "DELIVERY",
+                "DELIVERY_B2C"
+              ],
+              "type": "string"
+            },
+            "values": {
+              "items": {
+                "properties": {
+                  "cost": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "costPerStep": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "maxWeight": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "minWeight": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "step": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "calculationMechanic",
+            "chargeableParameter",
+            "serviceName",
+            "values"
+          ],
+          "type": "object"
+        },
+        {
+          "properties": {
+            "calculationMechanic": {
+              "const": "GAP_TO_PERCENT",
+              "type": "string"
+            },
+            "chargeableParameter": {
+              "const": "DECLARED_COST",
+              "type": "string"
+            },
+            "serviceName": {
+              "enum": [
+                "INSURANCE",
+                "INSURANCE_B2C"
+              ],
+              "type": "string"
+            },
+            "values": {
+              "items": {
+                "properties": {
+                  "maxDeclaredCost": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "percent": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "calculationMechanic",
+            "chargeableParameter",
+            "serviceName",
+            "values"
+          ],
+          "type": "object"
+        },
+        {
+          "properties": {
+            "calculationMechanic": {
+              "const": "WEIGHT_INTERVALS_WITH_MIN_COST",
+              "type": "string"
+            },
+            "chargeableParameter": {
+              "enum": [
+                "WEIGHT",
+                "PAID_WEIGHT"
+              ],
+              "type": "string"
+            },
+            "minCost": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "serviceName": {
+              "enum": [
+                "DELIVERY",
+                "DELIVERY_B2C"
+              ],
+              "type": "string"
+            },
+            "values": {
+              "items": {
+                "properties": {
+                  "cost": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "costPerStep": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "maxWeight": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "minWeight": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "step": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "calculationMechanic",
+            "chargeableParameter",
+            "minCost",
+            "serviceName",
+            "values"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  "name": {
+    "minLength": 1,
+    "type": "string"
+  }
+}

removedInput schema / properties / tariffZones / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / tariffZones / items / required
```
Added value: +[
+  "items",
+  "name"
+]
```
removedInput schema / properties / termsZones / items / additionalProperties
```
Removed value: -{}
```
removedInput schema / properties / termsZones / items / description
```
Removed value: -"See TermsZone in swaggers/delivery.json"
```

addedInput schema / properties / termsZones / items / properties

Added value: +{
+  "deliveryProviderZoneId": {
+    "type": "string"
+  },
+  "maxTerm": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "minTerm": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "name": {
+    "type": "string"
+  }
+}

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

Changed3 schema fields changedv0.8.1Jun 17, 2026

changedInput schema / properties / directions / items / description

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

changedInput schema / properties / tariffZones / items / description

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

changedInput schema / properties / termsZones / items / description

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

Changed11 schema fields changedv0.8.0May 31, 2026

changedInput schema / properties / deliveryProviderTariffId / description

Previous value: -"ID тарифа у провайдера."New value: +"Tariff identifier on the delivery-service side."

changedInput schema / properties / directions / description

Previous value: -"Направления."New value: +"Directions: directionTagFrom→directionTagTo link, tariff zone, minTerm/maxTerm (business days)."

changedInput schema / properties / directions / items / description

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

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 / name / description

Previous value: -"Название тарифа."New value: +"Human-readable tariff name (for the UI)."

changedInput schema / properties / tariffType / description

Previous value: -"Тип тарифа."New value: +"Tariff type (optional)."

changedInput schema / properties / tariffZones / description

Previous value: -"Зоны тарифа."New value: +"Tariff zones: name, deliveryProviderTariffZoneId, items (per-service price calculation models)."

changedInput schema / properties / tariffZones / items / description

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

changedInput schema / properties / termsZones / description

Previous value: -"Зоны сроков."New value: +"Delivery-term zones: deliveryProviderZoneId, name, minTerm/maxTerm (business days)."

changedInput schema / properties / termsZones / items / description

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

First observedv0.7.4May 28, 2026

TDQS

A4/5.0

Behavior4/5

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

Adds value beyond annotations: 'Returns 200 on accept', limits (400MB body, 1 million directions), and partner-only restriction. No contradiction with annotations (destructiveHint, readOnlyHint, idempotentHint are consistent). Could mention side effects more explicitly.

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

Conciseness4/5

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

Concise with front-loaded main action. Each sentence adds value: action, context, limits, audience, recommendations. Could be slightly more structured (e.g., bullet points) but overall efficient.

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?

Covers high-level purpose and limits but lacks output schema details (only 'Returns 200 on accept'). No error info or permission specifics beyond partner. For a complex 8-param tool, more completeness would help, but schema covers parameters well.

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% with detailed parameter descriptions. The tool description adds no parameter-specific info beyond schema; it only gives context (body size limit). Baseline of 3 is appropriate.

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?

Clearly states the verb 'Creates or replaces a tariff' and specifies the resource (tariff for delivery service). Distinguishes from siblings by explicitly recommending v2 over v1 and pairing with related tools. Includes scope (controls direction availability, cost, terms).

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

Usage Guidelines4/5

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

Provides clear context: when to use (to control delivery parameters), target audience (PARTNERS only), and a recommendation (prefer v2 over v1). Suggests complementary tools. Lacks explicit 'when not to use' but limits and audience exclusion suffice.

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

Deploy Server

Delivery: upload tariff [sandbox]

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools