Vendooly MCP

{
  "type": "object",
  "properties": {}
}

{
  "title": "List connected Amazon accounts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Amazon account status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "FBA inventory",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Lookback window in days (default 90)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "FBA inbound discrepancies",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "description": "Exact SKU filter (optional)."
    },
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Ledger lookback in days (default 90; reimbursements are read over days+60)."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Max SKUs returned (default 100), sorted by open units."
    },
    "only_open": {
      "type": "boolean",
      "description": "true = only SKUs with open (unreimbursed) units."
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "FBA lost/damaged vs reimbursements balance",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "description": "Filter: exact SKU"
    },
    "days": {
      "type": "number",
      "description": "Shipment-date lookback window in days (1-30, default 7)"
    },
    "order_id": {
      "type": "string",
      "description": "Filter: one Amazon order id (e.g. 402-1234567-1234567)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "max_orders": {
      "type": "number",
      "description": "Max orders returned (default 100, cap 1000)"
    }
  }
}

{
  "title": "FBA ship-from country per order",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Optional filter: ACTIVE | SHIPPED | VOIDED"
    },
    "page_size": {
      "type": "number",
      "description": "Page size (default/cap 30)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "FBA inbound plans (v2024)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "items",
    "source_address"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Nome del piano (max 40 char, opzionale)"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "sku",
          "quantity"
        ],
        "properties": {
          "sku": {
            "type": "string"
          },
          "quantity": {
            "type": "number"
          },
          "expiration": {
            "type": "string",
            "description": "YYYY-MM-DD (solo prodotti con scadenza)"
          },
          "prep_owner": {
            "type": "string",
            "description": "SELLER (default) | AMAZON | NONE"
          },
          "label_owner": {
            "type": "string",
            "description": "SELLER (default) | AMAZON | NONE"
          },
          "manufacturing_lot_code": {
            "type": "string",
            "description": "Lotto di produzione (se richiesto)"
          }
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "source_address": {
      "type": "object",
      "required": [
        "name",
        "address_line_1",
        "city",
        "postal_code",
        "country_code",
        "phone_number"
      ],
      "properties": {
        "city": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        },
        "company_name": {
          "type": "string"
        },
        "country_code": {
          "type": "string",
          "description": "ISO-2, es. IT"
        },
        "phone_number": {
          "type": "string"
        },
        "address_line_1": {
          "type": "string"
        },
        "address_line_2": {
          "type": "string"
        },
        "state_or_province_code": {
          "type": "string"
        }
      },
      "description": "Indirizzo di origine della merce"
    }
  }
}

{
  "title": "Create FBA inbound plan",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "operation_id": {
      "type": "string",
      "description": "Alternativa: polla lo stato di un'operazione async"
    },
    "inbound_plan_id": {
      "type": "string"
    }
  }
}

{
  "title": "FBA inbound plan detail",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "inbound_plan_id",
    "kind"
  ],
  "properties": {
    "kind": {
      "enum": [
        "packing",
        "placement"
      ],
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "regenerate": {
      "type": "boolean",
      "description": "true = forza una NUOVA generazione anche se esistono già opzioni"
    },
    "inbound_plan_id": {
      "type": "string"
    }
  }
}

{
  "title": "Generate inbound packing/placement options",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "inbound_plan_id",
    "kind",
    "option_id"
  ],
  "properties": {
    "kind": {
      "enum": [
        "packing",
        "placement"
      ],
      "type": "string"
    },
    "option_id": {
      "type": "string",
      "description": "packing_option_id o placement_option_id (da generate_inbound_options)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "inbound_plan_id": {
      "type": "string"
    }
  }
}

{
  "title": "Confirm inbound option",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "inbound_plan_id",
    "groupings"
  ],
  "properties": {
    "groupings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "boxes": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "length_cm",
                "width_cm",
                "height_cm",
                "weight_kg"
              ],
              "properties": {
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "sku",
                      "quantity"
                    ],
                    "properties": {
                      "sku": {
                        "type": "string"
                      },
                      "quantity": {
                        "type": "number"
                      },
                      "expiration": {
                        "type": "string",
                        "description": "YYYY-MM-DD. OBBLIGATORIA per prodotti con scadenza (alimentari, cosmetici…): senza, Amazon rifiuta il contenuto della scatola. Stesso SKU con scadenze diverse = righe separate (non nella stessa scatola)"
                      },
                      "prep_owner": {
                        "type": "string",
                        "description": "SELLER (default) | AMAZON | NONE"
                      },
                      "label_owner": {
                        "type": "string",
                        "description": "SELLER (default) | AMAZON | NONE"
                      },
                      "manufacturing_lot_code": {
                        "type": "string",
                        "description": "Lotto di produzione (se richiesto)"
                      }
                    }
                  }
                },
                "quantity": {
                  "type": "number",
                  "description": "Scatole identiche (default 1)"
                },
                "width_cm": {
                  "type": "number"
                },
                "height_cm": {
                  "type": "number"
                },
                "length_cm": {
                  "type": "number"
                },
                "weight_kg": {
                  "type": "number"
                },
                "content_source": {
                  "type": "string",
                  "description": "BOX_CONTENT_PROVIDED (default) | MANUAL_PROCESS | BARCODE_2D"
                }
              }
            }
          },
          "shipment_id": {
            "type": "string"
          },
          "packing_group_id": {
            "type": "string"
          }
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "inbound_plan_id": {
      "type": "string"
    }
  }
}

{
  "title": "Set inbound box information",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "inbound_plan_id"
  ],
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "inbound_plan_id": {
      "type": "string"
    }
  }
}

{
  "title": "Cancel FBA inbound plan",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "sku",
    "quantity"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "quantity": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Update FBM stock quantity",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "feed_id"
  ],
  "properties": {
    "wait": {
      "type": "boolean",
      "description": "true = attende fino a ~45s che il feed finisca prima di rispondere"
    },
    "feed_id": {
      "type": "string",
      "description": "ID del feed restituito da bulk_update_prices / bulk_update_inventory / bulk_update_listings / bulk_delete_listings / submit_listings_feed (NON il submissionId di update_listing)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Check feed status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max orders returned (most recent first). Omit for all."
    },
    "statuses": {
      "type": "array"
    },
    "days_back": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "List recent orders",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Order line items",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "description": "Exact SKU filter."
    },
    "asin": {
      "type": "string"
    },
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Calendar days, default 30; omit when using start_date/end_date."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows per page, default 100; summaries cover all filtered rows."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Next page: pass next_offset with the same report_id and filters."
    },
    "reason": {
      "type": "string",
      "description": "Exact original Amazon reason code."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive return date YYYY-MM-DD, not future."
    },
    "order_id": {
      "type": "string"
    },
    "report_id": {
      "type": "string",
      "description": "Resume or paginate the report returned by this tool, on the same outpost."
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive return date YYYY-MM-DD, paired with end_date."
    },
    "detailed_disposition": {
      "type": "string",
      "description": "Exact original Amazon disposition, distinct from reason and status."
    }
  }
}

{
  "title": "Detailed FBA customer returns",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "start_date",
    "end_date"
  ],
  "properties": {
    "refresh": {
      "type": "boolean",
      "description": "Regenerate a finished export for the same period instead of returning the cached one."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive posted date YYYY-MM-DD (UTC), not future."
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive posted date YYYY-MM-DD (UTC)."
    }
  }
}

{
  "title": "Fiscal transactions file (VAT, ship-to country, B2B)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 0,
      "description": "How many top ASINs by reported weight to list, default 20. Summaries always cover all rows."
    },
    "period": {
      "type": "string",
      "description": "Closed period: YYYY-MM (monthly), YYYY-Qn e.g. 2026-Q2 (quarterly), YYYY (annual). Default: last closed period of that type. Current/future periods are rejected."
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional ship-to country filter, ISO 2 letters (DE, FR, ES…). Totals then cover only that country."
    },
    "refresh": {
      "type": "boolean",
      "description": "true = ask Amazon for a new report instead of reusing a ready one for the same period."
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "period_type": {
      "enum": [
        "monthly",
        "quarterly",
        "annual"
      ],
      "type": "string",
      "description": "Aggregation of the Amazon report. Default monthly."
    }
  }
}

{
  "title": "EPR report summary (packaging, WEEE, batteries)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "top_n": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "wait_timeout_sec": {
      "type": "number"
    }
  }
}

{
  "title": "Catalog quality audit",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "sku",
    "product_data"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "product_data": {
      "type": "object",
      "properties": {
        "ean": {
          "type": "string"
        },
        "asin": {
          "type": "string"
        },
        "brand": {
          "type": "string"
        },
        "price": {
          "type": "number"
        },
        "title": {
          "type": "string"
        },
        "quantity": {
          "type": "number"
        },
        "condition": {
          "type": "string"
        },
        "attributes": {
          "type": "object"
        },
        "productType": {
          "type": "string"
        },
        "requirements": {
          "type": "string"
        },
        "validate_only": {
          "type": "boolean"
        }
      }
    }
  }
}

{
  "title": "Create listing",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Nuovo titolo (item_name)"
    },
    "bullets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Punti elenco (bullet_point), fino a 5"
    },
    "patches": {
      "type": "array",
      "description": "JSON Patch SP-API grezzi (alternativa agli shortcut)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "product_type": {
      "type": "string",
      "description": "Product type Amazon (es. WINDOW_SHADE). Opzionale: se manca si legge dalla listing; passalo solo per forzarlo"
    },
    "validate_only": {
      "type": "boolean",
      "description": "true = dry-run, valida senza scrivere"
    },
    "shipping_template": {
      "type": "string",
      "description": "Modello di spedizione da assegnare (ID o nome come in Seller Central). Elenco: get_product_types product_type=\"PRODUCT\" → shipping_templates"
    }
  }
}

{
  "title": "Update listing",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "include_data": {
      "type": "array"
    }
  }
}

{
  "title": "Get listing",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Delete listing",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Elenco esplicito di SKU: salta il report e ignora channel"
    },
    "channel": {
      "enum": [
        "FBM",
        "FBA",
        "ALL"
      ],
      "type": "string",
      "description": "Quali offerte cancellare (default FBM = solo quelle gestite dal venditore)"
    },
    "confirm": {
      "type": "boolean",
      "description": "true, insieme a plan_id, per eseguire davvero"
    },
    "plan_id": {
      "type": "string",
      "description": "Piano restituito dalla prima chiamata (fase 2)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Bulk delete listings (by fulfillment channel)",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "keywords": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "identifiers": {
      "type": "string"
    },
    "identifierType": {
      "type": "string"
    }
  }
}

{
  "title": "Search Amazon catalog",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "product_type"
  ],
  "properties": {
    "locale": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attribute names whose structure you need (e.g. [\"care_instructions\",\"material\"])"
    },
    "raw_schema": {
      "type": "boolean"
    },
    "product_type": {
      "type": "string"
    },
    "include_enums": {
      "type": "boolean"
    }
  }
}

{
  "title": "Product type definition",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "channel": {
      "type": "string",
      "description": "FBA | FBM"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "only_in_stock": {
      "type": "boolean"
    }
  }
}

{
  "title": "List my products",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "asin"
  ],
  "properties": {
    "asin": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "My product detail",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "asin"
  ],
  "properties": {
    "asin": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Amazon catalog item",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "asins"
  ],
  "properties": {
    "asins": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Competitive pricing",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "asins"
  ],
  "properties": {
    "asins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of ASINs (max 100 per call)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "customer_type": {
      "type": "string",
      "description": "Consumer (default) or Business for B2B prices"
    }
  }
}

{
  "title": "Buy Box prices (bulk)",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "skus"
  ],
  "properties": {
    "skus": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "My pricing",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "price"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "asin": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "currency": {
      "type": "string",
      "description": "ISO code, default EUR"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "fulfillment_channel": {
      "type": "string",
      "description": "FBA (default) or FBM"
    }
  }
}

{
  "title": "Estimate Amazon fees",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "sku",
    "price"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Update price",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Bulk update prices",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Bulk update inventory",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "sku"
        ],
        "properties": {
          "sku": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "bullets": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "patches": {
            "type": "array"
          },
          "product_type": {
            "type": "string"
          },
          "validate_only": {
            "type": "boolean"
          }
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Bulk update listing attributes (title, bullets, patches)",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "skus",
    "shipping_template"
  ],
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SKU a cui assegnare il modello"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "validate_only": {
      "type": "boolean",
      "description": "true = valida su 3 SKU di prova, nessun feed"
    },
    "shipping_template": {
      "type": "string",
      "description": "ID o nome del modello di spedizione"
    }
  }
}

{
  "title": "Bulk assign shipping template",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "refresh": {
      "type": "boolean",
      "description": "true = ignore the ~6h cache and request a fresh report from Amazon (use only if the user asks for the very latest data)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Account health",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "asins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ASIN da controllare (max 100). Accetta anche una stringa separata da virgole/a capo."
    },
    "brands": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "MODALITÀ PER MARCHIO (senza asins/identifiers): nomi di marchio da controllare (max 10), quando il fornitore non dà ASIN né EAN. Per ogni marchio lo strumento prende dal catalogo i suoi ASIN più venduti (campione) e dà un verdetto per marchio (libero / da_sbloccare / non_vendibile / marchio_non_trovato) con il numero di ASIN valutati e la confidenza. È una STIMA: per decidere un acquisto controlla poi gli ASIN/EAN esatti."
    },
    "category": {
      "type": "string",
      "description": "Solo con brands: categoria in parole (es. \"giocattoli\", \"integratori\") per limitare il campione a quella categoria del marchio. Il campione è dichiarato come campione di categoria."
    },
    "condition": {
      "enum": [
        "new_new",
        "new_open_box",
        "new_oem",
        "refurbished_refurbished",
        "used_like_new",
        "used_very_good",
        "used_good",
        "used_acceptable",
        "collectible_like_new",
        "collectible_very_good",
        "collectible_good",
        "collectible_acceptable",
        "club_club"
      ],
      "type": "string",
      "description": "Condizione di vendita (default new_new = Nuovo)."
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "In alternativa/aggiunta: codici EAN/UPC/GTIN (es. dal listino fornitore), convertiti in ASIN con il catalogo Amazon del marketplace dell'outpost (max 100 in totale con asins)."
    },
    "sample_size": {
      "type": "integer",
      "maximum": 10,
      "minimum": 3,
      "description": "Solo con brands: ASIN per marchio nel campione (default 5)."
    },
    "include_brand": {
      "type": "boolean",
      "description": "Default true: legge il brand dal catalogo per raggruppare. false = più veloce, tutto sotto \"brand sconosciuto\"."
    },
    "reason_locale": {
      "type": "string",
      "description": "Lingua dei messaggi Amazon (es. it_IT); default = lingua del primo marketplace."
    },
    "identifier_type": {
      "enum": [
        "EAN",
        "UPC",
        "GTIN"
      ],
      "type": "string",
      "description": "Tipo dei codici in identifiers (default EAN)."
    },
    "marketplace_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Marketplace da controllare (max 5, stessa region dell'outpost, es. APJ6JRA9NG5V4 = amazon.it, A1PA6795UKMFR9 = amazon.de). Default: il marketplace dell'outpost."
    },
    "classification_id": {
      "type": "string",
      "description": "Solo con brands: id numerico del nodo di categoria Amazon (browse node) per limitare il campione. Alternativo o insieme a category."
    }
  }
}

{
  "title": "Can I sell it? Gated ASIN/brand check",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "skus": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "issue_locale": {
      "type": "string"
    }
  }
}

{
  "title": "Listing issues",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "scope": {
      "enum": [
        "not_buyable",
        "search_suppressed",
        "errors",
        "all"
      ],
      "type": "string",
      "description": "not_buyable (default) = tutto ciò che il cliente non può comprare"
    },
    "top_n": {
      "type": "number",
      "description": "Quanti item dettagliati restituire (default 50); by_reason li conta comunque tutti"
    },
    "max_pages": {
      "type": "number",
      "description": "Pagine da 20 SKU da scorrere (default 25 = 500 SKU, max 50 = cap Amazon)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "issue_locale": {
      "type": "string",
      "description": "Lingua dei messaggi Amazon (es. it_IT); default = lingua del marketplace"
    },
    "changed_since": {
      "type": "string",
      "description": "Solo listing aggiornati da questa data (YYYY-MM-DD o ISO8601) — \"cosa si è rotto dopo il batch di ieri\""
    },
    "check_fba_stock": {
      "type": "boolean",
      "description": "Default true: legge FBA Inventory (1 chiamata) per spiegare gli SKU FBA che Amazon non motiva. false = report più rapido, quegli SKU restano \"motivo non dichiarato\""
    },
    "stranded_wait_sec": {
      "type": "number",
      "description": "Attesa massima del report stranded in secondi (default 60, max 300); oltre → stranded_report.pending e si riprende al giro dopo"
    },
    "check_stranded_report": {
      "type": "boolean",
      "description": "Report Stranded Inventory (~20 s, riusato 20 min) per la causa reale degli stranded. Default automatico: richiesto solo se ci sono SKU stranded; true = forzalo (porta anche gli SKU stranded con offerta cancellata, invisibili alla ricerca listing); false = saltalo"
    }
  }
}

{
  "title": "Listing inattivi/soppressi + motivo",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "max_pages": {
      "type": "number",
      "description": "Pages of 20 listings to scan (default 10 = up to 200 listings)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Title length compliance audit",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SKU da pianificare (vuoto = scansione del catalogo fino a limit)"
    },
    "limit": {
      "type": "number",
      "description": "Massimo SKU (default 200, max 1000)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "new_titles": {
      "type": "object",
      "description": "Mappa sku → titolo corto deciso dal seller (al posto del taglio automatico)",
      "additionalProperties": {
        "type": "string"
      }
    },
    "include_bullets": {
      "type": "boolean",
      "description": "false = non toccare bullet e descrizione: ciò che non entra nelle keyword resta in manual_review (default true)"
    },
    "original_titles": {
      "type": "object",
      "description": "Mappa sku → titolo lungo originale, quando il titolo è già stato tagliato",
      "additionalProperties": {
        "type": "string"
      }
    }
  }
}

{
  "title": "Plan title fix keeping SEO",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "plan_id"
  ],
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SKU del lotto (vuoto = tutti i ready, se entro il limite del lotto)"
    },
    "plan_id": {
      "type": "string",
      "description": "plan_id da plan_title_seo_fix"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Apply title-SEO batch",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Title-SEO status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "batch_id"
  ],
  "properties": {
    "batch_id": {
      "type": "string",
      "description": "batch_id da apply_title_seo_batch o title_seo_status"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Roll back title-SEO batch",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "standard",
        "full"
      ],
      "type": "string",
      "description": "standard (default) = compliance/GPSR curati; full = tutti gli attributi required dello schema del product type + tutte le issue Amazon"
    },
    "max_pages": {
      "type": "number",
      "description": "Pagine di 20 listing da scansionare (default 10 = ~200 SKU)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Compliance / GPSR audit",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "sku",
    "highlights"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "confirm": {
      "type": "boolean",
      "description": "true to apply after reviewing the dry-run"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "highlights": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of highlight strings (frasi brevi separate, totale ≤ 125 char)"
    },
    "product_type": {
      "type": "string",
      "description": "Amazon product type — auto-detected if omitted"
    }
  }
}

{
  "title": "Update item highlights",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "top_n": {
      "type": "number",
      "description": "Quante righe per lista (default 25)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "max_catalog": {
      "type": "number",
      "description": "Max SKU di catalogo da scansionare (default 1000)"
    },
    "max_documents": {
      "type": "number",
      "description": "Max documenti A+ da espandere in ASIN (default 200)"
    }
  }
}

{
  "title": "A+ Content coverage audit",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "max_pages": {
      "type": "number",
      "description": "Pagine di documenti da scorrere (default 10)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "List A+ Content documents",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "content_reference_key"
  ],
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "include_content": {
      "type": "boolean",
      "description": "true = includi i moduli completi"
    },
    "content_reference_key": {
      "type": "string"
    }
  }
}

{
  "title": "A+ Content document detail",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Account KPI dashboard",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "All accounts KPI dashboard",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string"
    },
    "region": {
      "enum": [
        "na",
        "eu",
        "fe"
      ],
      "type": "string",
      "description": "Vendor Central region (default eu)"
    },
    "redirect_uri": {
      "type": "string"
    }
  }
}

{
  "title": "Generate Vendor authorization link",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days_back": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "po_item_state": {
      "type": "string"
    },
    "include_details": {
      "type": "boolean"
    }
  }
}

{
  "title": "Vendor purchase orders",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "po_number"
  ],
  "properties": {
    "po_number": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Vendor PO details",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days_back": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Vendor PO summary",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days_back": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "ship_from_party_id": {
      "type": "string"
    }
  }
}

{
  "title": "Vendor invoices (SP-API limit: usa remittances)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days_back": {
      "type": "number"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "summary_only": {
      "type": "boolean"
    }
  }
}

{
  "title": "Vendor: stima importi da PO",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "List Ads profiles",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "List Ads portfolios",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "portfolio"
  ],
  "properties": {
    "portfolio": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "profile_id": {
          "type": "string"
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create Ads portfolio",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array"
    }
  }
}

{
  "title": "List SP campaigns",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "campaign"
  ],
  "properties": {
    "campaign": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "state": {
          "enum": [
            "ENABLED",
            "PAUSED",
            "ARCHIVED"
          ],
          "type": "string"
        },
        "end_date": {
          "type": "string"
        },
        "profile_id": {
          "type": "string"
        },
        "start_date": {
          "type": "string"
        },
        "daily_budget": {
          "type": "number"
        },
        "portfolio_id": {
          "type": "string"
        },
        "targeting_type": {
          "enum": [
            "MANUAL",
            "AUTO"
          ],
          "type": "string"
        },
        "dynamic_bidding": {
          "type": "object"
        },
        "placement_bidding": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "placement": {
                "type": "string"
              },
              "percentage": {
                "type": "number"
              }
            }
          }
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP campaign",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "campaign_id"
        ],
        "properties": {
          "state": {
            "enum": [
              "ENABLED",
              "PAUSED"
            ],
            "type": "string"
          },
          "campaign_id": {
            "type": "string"
          },
          "daily_budget": {
            "type": "number"
          },
          "placement_bidding": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "placement": {
                  "type": "string"
                },
                "percentage": {
                  "type": "number"
                }
              }
            }
          }
        }
      },
      "description": "Batch: [{campaign_id, daily_budget?, state?, placement_bidding?}], max 25"
    },
    "patches": {
      "type": "object",
      "properties": {
        "state": {
          "enum": [
            "ENABLED",
            "PAUSED"
          ],
          "type": "string"
        },
        "budget": {
          "type": "object"
        },
        "profile_id": {
          "type": "string"
        },
        "daily_budget": {
          "type": "number"
        },
        "dynamicBidding": {
          "type": "object"
        },
        "bidding_strategy": {
          "enum": [
            "LEGACY_FOR_SALES",
            "AUTO_FOR_SALES",
            "MANUAL",
            "RULE_BASED"
          ],
          "type": "string"
        },
        "placement_bidding": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "placement",
              "percentage"
            ],
            "properties": {
              "placement": {
                "type": "string"
              },
              "percentage": {
                "type": "number"
              }
            }
          },
          "description": "Moltiplicatori per placement: [{placement, percentage}] (0-900)"
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP campaign",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string",
      "description": "Lingua dei nomi, es. it_IT, de_DE, en_GB (opzionale)"
    },
    "search": {
      "type": "string",
      "description": "Filtro testuale sul nome del pubblico (opzionale)"
    },
    "source": {
      "enum": [
        "amazon",
        "amc",
        "all"
      ],
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "List SP audience segments",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "set": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "audience_id",
          "percentage"
        ],
        "properties": {
          "percentage": {
            "type": "integer"
          },
          "audience_id": {
            "type": "string"
          }
        }
      },
      "description": "Aggiungi o modifica: [{audience_id, percentage 0-900 intero}]"
    },
    "remove": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "audience_id da togliere"
    },
    "confirm": {
      "type": "boolean",
      "description": "false/assente = solo anteprima; true = scrive (dopo ok dell'utente)"
    },
    "clear_all": {
      "type": "boolean",
      "description": "true = toglie TUTTI i segmenti della campagna"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP audience bid adjustments",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "campaign_ids"
  ],
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ID delle campagne da archiviare"
    }
  }
}

{
  "title": "Archive SP campaign",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "List SP ad groups",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "ad_group"
  ],
  "properties": {
    "ad_group": {
      "type": "object",
      "required": [
        "name",
        "campaign_id",
        "default_bid"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "state": {
          "enum": [
            "ENABLED",
            "PAUSED"
          ],
          "type": "string"
        },
        "profile_id": {
          "type": "string"
        },
        "campaign_id": {
          "type": "string"
        },
        "default_bid": {
          "type": "number"
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP ad group",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "ad_group_id",
    "patches"
  ],
  "properties": {
    "patches": {
      "type": "object"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "ad_group_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP ad group",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "campaign_id_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "List SB campaigns",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "campaign_id"
        ],
        "properties": {
          "state": {
            "enum": [
              "ENABLED",
              "PAUSED"
            ],
            "type": "string"
          },
          "campaign_id": {
            "type": "string"
          },
          "daily_budget": {
            "type": "number"
          },
          "bid_adjustments_by_placement": {
            "type": "array"
          }
        }
      },
      "description": "Batch: [{campaign_id, daily_budget?, state?, bid_adjustments_by_placement?}], max 25"
    },
    "patches": {
      "type": "object",
      "properties": {
        "state": {
          "enum": [
            "ENABLED",
            "PAUSED"
          ],
          "type": "string"
        },
        "profile_id": {
          "type": "string"
        },
        "daily_budget": {
          "type": "number"
        },
        "bid_optimization": {
          "type": [
            "boolean",
            "string"
          ],
          "description": "true/AUTO = ottimizza Amazon · false/MANUAL = moltiplicatori manuali (richiede bid_adjustments_by_placement)"
        },
        "bid_adjustments_by_placement": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "placement",
              "percentage"
            ],
            "properties": {
              "placement": {
                "type": "string",
                "description": "TOP_OF_SEARCH | DETAIL_PAGE | HOME | OTHER (alias: top, detail_page, home, other)"
              },
              "percentage": {
                "type": "number",
                "description": "aumento % dell'offerta su quel posizionamento — SOLO positivo (Amazon rifiuta i negativi dal 15/6/2026)"
              }
            }
          }
        }
      }
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SB campaign",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_id_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "List SB ad groups",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "ad_group_id",
    "patches"
  ],
  "properties": {
    "patches": {
      "type": "object"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "ad_group_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SB ad group",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "List SB keywords",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "bid": {
      "type": "number"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "keyword_id",
          "bid"
        ],
        "properties": {
          "bid": {
            "type": "number"
          },
          "keyword_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{keyword_id, bid}], max 25"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "keyword_id": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SB keyword bid",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "keyword_id",
          "state"
        ],
        "properties": {
          "state": {
            "type": "string"
          },
          "keyword_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{keyword_id, state}], max 25"
    },
    "state": {
      "enum": [
        "ENABLED",
        "PAUSED",
        "ARCHIVED"
      ],
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "keyword_id": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SB keyword state",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "List SB product targets",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "bid": {
      "type": "number"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "target_id",
          "bid"
        ],
        "properties": {
          "bid": {
            "type": "number"
          },
          "target_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{target_id, bid}], max 25"
    },
    "target_id": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SB target bid",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "target_id",
          "state"
        ],
        "properties": {
          "state": {
            "type": "string"
          },
          "target_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{target_id, state}], max 25"
    },
    "state": {
      "enum": [
        "ENABLED",
        "PAUSED",
        "ARCHIVED"
      ],
      "type": "string"
    },
    "target_id": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SB target state",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "campaign_id_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "List SD campaigns",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "campaign_id"
        ],
        "properties": {
          "state": {
            "type": "string"
          },
          "campaign_id": {
            "type": "string"
          },
          "daily_budget": {
            "type": "number"
          }
        }
      },
      "description": "Batch: [{campaign_id, daily_budget?, state?}], max 25"
    },
    "state": {
      "enum": [
        "enabled",
        "paused",
        "archived"
      ],
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    },
    "daily_budget": {
      "type": "number"
    }
  }
}

{
  "title": "Update SD campaign",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "campaign_id_filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

{
  "title": "List SD ad groups",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "bid": {
      "type": "number"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "ad_group_id"
        ],
        "properties": {
          "bid": {
            "type": "number"
          },
          "state": {
            "type": "string"
          },
          "ad_group_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{ad_group_id, bid?, state?}], max 25"
    },
    "state": {
      "enum": [
        "enabled",
        "paused",
        "archived"
      ],
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SD ad group",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "List SP keywords",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "keywords"
  ],
  "properties": {
    "keywords": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP keywords",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "bid": {
      "type": "number"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "keyword_id",
          "bid"
        ],
        "properties": {
          "bid": {
            "type": "number"
          },
          "keyword_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{keyword_id, bid}], max 25"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "keyword_id": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP keyword bid",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "keyword_id",
          "state"
        ],
        "properties": {
          "state": {
            "type": "string"
          },
          "keyword_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{keyword_id, state}], max 25"
    },
    "state": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "keyword_id": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP keyword state",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "List SP negative keywords",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "negatives"
  ],
  "properties": {
    "negatives": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP negative keywords",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "keyword_ids"
  ],
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "keyword_ids": {
      "type": "array"
    }
  }
}

{
  "title": "Delete SP negative keywords",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string"
    },
    "asin": {
      "type": "string"
    },
    "all_pages": {
      "type": "boolean",
      "default": true
    },
    "page_size": {
      "type": "integer",
      "default": 200,
      "maximum": 500,
      "minimum": 1
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "next_token": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array",
      "items": {
        "enum": [
          "ENABLED",
          "PAUSED",
          "ARCHIVED"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Default ENABLED e PAUSED"
    }
  }
}

{
  "title": "List SP product ads",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "lookback_days": {
      "type": "integer",
      "default": 30,
      "maximum": 365,
      "minimum": 1
    },
    "only_in_stock": {
      "type": "boolean",
      "default": false
    },
    "only_uncovered": {
      "type": "boolean",
      "default": false,
      "description": "Solo sp_covered=false, inclusi gli esauriti se only_in_stock=false"
    },
    "only_with_sales": {
      "type": "boolean",
      "default": false
    },
    "ignore_orphan_ads": {
      "type": "boolean",
      "default": false,
      "description": "Se Amazon non restituisce alcune campagne/gruppi referenziati dalle Product Ads, esclude quegli annunci orfani (non in erogazione) invece di fermarsi; il risultato li elenca in orphan_ad_ids."
    }
  }
}

{
  "title": "Check catalog SP coverage",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "ad_id": {
      "type": "string"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "ad_id",
          "state"
        ],
        "properties": {
          "ad_id": {
            "type": "string"
          },
          "state": {
            "enum": [
              "ENABLED",
              "PAUSED"
            ],
            "type": "string"
          }
        }
      },
      "maxItems": 25,
      "description": "Batch: [{ad_id, state}], max 25"
    },
    "state": {
      "enum": [
        "ENABLED",
        "PAUSED"
      ],
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP product ad state",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "ads"
  ],
  "properties": {
    "ads": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP product ads",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    },
    "state_filter": {
      "type": "array"
    }
  }
}

{
  "title": "List SP product targets",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "targets"
  ],
  "properties": {
    "targets": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP product targets",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "bid": {
      "type": "number"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "target_id",
          "bid"
        ],
        "properties": {
          "bid": {
            "type": "number"
          },
          "target_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{target_id, bid}], max 25"
    },
    "target_id": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP target bid",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "target_id",
          "state"
        ],
        "properties": {
          "state": {
            "type": "string"
          },
          "target_id": {
            "type": "string"
          }
        }
      },
      "description": "Batch: [{target_id, state}], max 25"
    },
    "state": {
      "type": "string"
    },
    "target_id": {
      "type": "string"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    }
  }
}

{
  "title": "Update SP target state",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "target_ids"
  ],
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "target_ids": {
      "type": "array"
    }
  }
}

{
  "title": "Delete SP product targets",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  }
}

{
  "title": "List SP negative targets",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "targets"
  ],
  "properties": {
    "targets": {
      "type": "array"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Create SP negative targets",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "target_ids"
  ],
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "profile_id": {
      "type": "string"
    },
    "target_ids": {
      "type": "array"
    }
  }
}

{
  "title": "Delete SP negative targets",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Vendor trading terms (SP-API limit: vedi Vendor Central)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Days to analyze (default 7)"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Weekly business recap",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Period width in days (default 7)"
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Amazon OrderStatuses to include in the comparison (SP-API enum, e.g. Shipped, Unshipped, PartiallyShipped, Pending, Canceled). Default: all of the former."
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    }
  }
}

{
  "title": "Diagnose sales drop",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "skus"
  ],
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "delta": {
      "type": "number",
      "description": "How far below the Buy Box to price (default 0.01)"
    },
    "floor": {
      "type": "number",
      "description": "Hard minimum price"
    },
    "confirm": {
      "type": "boolean",
      "description": "true = actually apply the prices"
    },
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    }
  }
}

{
  "title": "Reprice to Buy Box",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "ad_product": {
      "enum": [
        "SP",
        "SB",
        "SD"
      ],
      "type": "string",
      "description": "Tipo di campagne da controllare (default SP)"
    },
    "profile_id": {
      "type": "string"
    },
    "campaign_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Campagne specifiche; se omesso controlla tutte le ENABLED"
    },
    "max_campaigns": {
      "type": "number",
      "description": "Tetto di campagne da controllare in auto-discovery (default 300)"
    },
    "threshold_percent": {
      "type": "number",
      "description": "Soglia per la lista at_risk (default 80)"
    }
  }
}

{
  "title": "Ads intraday budget usage",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost."
    },
    "profile_id": {
      "type": "string"
    },
    "days_threshold": {
      "type": "number",
      "description": "Days-of-cover threshold (default 14)"
    }
  }
}

{
  "title": "Ads stock-out check",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max findings (default 50, cap 200)"
    },
    "status": {
      "enum": [
        "open",
        "approved",
        "executed",
        "dismissed",
        "resolved",
        "all"
      ],
      "type": "string",
      "description": "Filtro stato (default open)"
    },
    "rule_key": {
      "enum": [
        "buybox_lost",
        "buybox_suppressed",
        "stockout_risk",
        "ads_no_stock",
        "negative_margin",
        "listing_issue_99300"
      ],
      "type": "string",
      "description": "Solo una regola"
    },
    "severity": {
      "enum": [
        "critical",
        "high",
        "medium"
      ],
      "type": "string"
    }
  }
}

{
  "title": "Daily operational findings",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "enum": [
        "campaign",
        "keyword",
        "search_term"
      ],
      "type": "string",
      "description": "Granularità (default campaign)"
    },
    "limit": {
      "type": "number",
      "description": "Max righe (default 50, cap 200), ordinate per spesa"
    },
    "action": {
      "type": "string",
      "description": "Filtra le righe per action (es. BID_DOWN, NEGATIVE_EXACT)"
    },
    "window": {
      "enum": [
        7,
        14,
        30
      ],
      "type": "number",
      "description": "Giorni della finestra chiusa (default 14)"
    },
    "acos_max": {
      "type": "number",
      "description": "ACoS target in % per tutti gli outpost; se omesso si usa acos_max del cockpit per outpost"
    },
    "ad_product": {
      "enum": [
        "SP",
        "SB",
        "SD"
      ],
      "type": "string",
      "description": "Solo livello campaign (default SP)"
    },
    "campaign_id": {
      "type": "string",
      "description": "Solo questa campagna (utile per keyword/search_term)"
    }
  }
}

{
  "title": "Ads performance (fixed windows, rules)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "List documentation topics",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string"
    }
  }
}

{
  "title": "Read documentation topic",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "include_archived": {
      "type": "boolean",
      "description": "Also list archived SOP (default false)."
    }
  }
}

{
  "title": "List operating procedures (SOP)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "sop_id"
  ],
  "properties": {
    "sop_id": {
      "type": "integer"
    }
  }
}

{
  "title": "Read an operating procedure",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "body": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        }
      }
    },
    "title": {
      "type": "string"
    },
    "sop_id": {
      "type": "integer",
      "description": "Omit to create a new SOP."
    },
    "source": {
      "type": "string",
      "description": "Where it comes from, e.g. \"crm:sop#30\"."
    },
    "status": {
      "enum": [
        "active",
        "archived"
      ],
      "type": "string"
    },
    "schedule": {
      "type": "string",
      "description": "Free text, e.g. \"daily 08:30\" or \"Monday\"."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "description": {
      "type": "string"
    },
    "outpost_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    }
  }
}

{
  "title": "Save an operating procedure",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "include_archived": {
      "type": "boolean"
    }
  }
}

{
  "title": "List cockpits",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "month": {
      "type": "string",
      "description": "YYYY-MM, default current month (Europe/Rome)."
    },
    "cockpit_id": {
      "type": "integer"
    },
    "include_health": {
      "type": "boolean"
    },
    "include_dormant": {
      "type": "boolean",
      "description": "Include also dormant marketplaces (< 10 units in the last 30 days); default: hidden and counted in dormant_summary."
    }
  }
}

{
  "title": "Cockpit: targets and traffic light",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived"
      ],
      "type": "string"
    },
    "cockpit_id": {
      "type": "integer"
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "description": {
      "type": "string"
    },
    "outpost_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    }
  }
}

{
  "title": "Save a cockpit",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "outpost_id",
    "month",
    "sales_target"
  ],
  "properties": {
    "vat": {
      "enum": [
        "inclusa",
        "esclusa"
      ],
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "month": {
      "type": "string",
      "description": "YYYY-MM"
    },
    "status": {
      "enum": [
        "proposto",
        "validato",
        "concordato"
      ],
      "type": "string"
    },
    "acos_max": {
      "type": "number",
      "description": "Max ACoS % (optional)."
    },
    "tacos_max": {
      "type": "number",
      "description": "Max TACoS % (optional)."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "outpost_id": {
      "type": "integer"
    },
    "sales_target": {
      "type": "number"
    }
  }
}

{
  "title": "Set a monthly sales target",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "kpi": {
      "enum": [
        "sales",
        "acos",
        "tacos",
        "buybox",
        "stock",
        "listing",
        "other"
      ],
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "Max rows (default 50, cap 200)."
    },
    "outpost_id": {
      "type": "integer",
      "description": "Outpost (seller × marketplace) id; omit for all visible outposts."
    }
  }
}

{
  "title": "Operations history per outpost",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "outpost_id",
    "kpi",
    "action_type",
    "description"
  ],
  "properties": {
    "kpi": {
      "enum": [
        "sales",
        "acos",
        "tacos",
        "buybox",
        "stock",
        "listing",
        "other"
      ],
      "type": "string",
      "description": "KPI the operation is meant to move."
    },
    "ref": {
      "type": "string",
      "description": "Optional: campaign/keyword/SKU/ASIN id or a link."
    },
    "actor_ref": {
      "type": "string",
      "description": "Optional: name of the person/agent/session."
    },
    "actor_type": {
      "enum": [
        "user",
        "ai",
        "session"
      ],
      "type": "string",
      "description": "Who did it (default user)."
    },
    "outpost_id": {
      "type": "integer"
    },
    "action_type": {
      "type": "string",
      "description": "Short code, e.g. bid_change, budget_change, price_change, negative_keyword, listing_fix (max 60 chars)."
    },
    "description": {
      "type": "string",
      "description": "What was done, in one sentence (max 500 chars)."
    },
    "value_after": {
      "type": "string"
    },
    "value_before": {
      "type": "string"
    }
  }
}

{
  "title": "Record an operation on an outpost",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "email",
    "role"
  ],
  "properties": {
    "role": {
      "enum": [
        "admin",
        "member"
      ],
      "type": "string",
      "description": "admin = full access; member = only the sellers in seller_ids."
    },
    "email": {
      "type": "string",
      "description": "Email of the person to invite."
    },
    "store_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "For role=member: WooCommerce store ids (from list_team_members → stores) the member may see. Omitted = none."
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "seller_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "For role=member: seller ids (from list_team_members → sellers) the member may see."
    },
    "send_email": {
      "type": "boolean",
      "description": "true (default): email the invitation. false: no email, return the invite link."
    },
    "permissions": {
      "type": "object",
      "properties": {
        "ads": {
          "enum": [
            "none",
            "read",
            "write"
          ],
          "type": "string"
        },
        "sales": {
          "enum": [
            "none",
            "read"
          ],
          "type": "string"
        },
        "catalog": {
          "enum": [
            "none",
            "read",
            "write"
          ],
          "type": "string"
        },
        "account_team": {
          "enum": [
            "none",
            "read"
          ],
          "type": "string"
        },
        "pricing_inventory": {
          "enum": [
            "none",
            "read",
            "write"
          ],
          "type": "string"
        }
      },
      "description": "For role=member: access level per function, each none | read | write. Keys: sales (max read), catalog, pricing_inventory, ads, account_team (max read). Omitted keys = none. If permissions is omitted entirely the member gets read-only on sales, catalog, pricing_inventory and ads, and none on account_team. Price/stock and Ads writes must be granted explicitly. Ignored for admin (full access)."
    }
  }
}

{
  "title": "Invite a person to your organization",
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "List team members",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "The feedback in the user's own words (what happened / what they want)."
    },
    "category": {
      "enum": [
        "bug",
        "idea",
        "question",
        "other"
      ],
      "type": "string",
      "description": "Type of feedback (default other)."
    },
    "ai_context": {
      "type": "string",
      "description": "Short note: what the user was doing, which account/tool, any error message you observed."
    }
  }
}

{
  "title": "Send feedback to Vendooly",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "List connected WooCommerce stores",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "store_id"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "Max products (default 50, cap 500)"
    },
    "search": {
      "type": "string"
    },
    "status": {
      "enum": [
        "any",
        "publish",
        "draft",
        "pending",
        "private"
      ],
      "type": "string"
    },
    "store_id": {
      "type": "string",
      "description": "From woo_list_stores"
    },
    "include_variations": {
      "type": "boolean",
      "description": "Default true"
    }
  }
}

{
  "title": "WooCommerce products",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "store_id"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "Max products (default 100, cap 500)"
    },
    "store_id": {
      "type": "string"
    },
    "product_id": {
      "type": "string"
    },
    "low_stock_threshold": {
      "type": "number"
    }
  }
}

{
  "title": "WooCommerce stock",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "store_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max orders (default 50, cap 200)"
    },
    "status": {
      "type": "string",
      "description": "WooCommerce status, e.g. processing, completed, on-hold (comma separated allowed)"
    },
    "store_id": {
      "type": "string"
    },
    "days_back": {
      "type": "number",
      "description": "Default 30, max 365"
    }
  }
}

{
  "title": "WooCommerce orders",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "store_id",
    "product_id",
    "quantity"
  ],
  "properties": {
    "quantity": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0
    },
    "store_id": {
      "type": "string"
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "product_id": {
      "type": "string"
    },
    "variation_id": {
      "type": "string",
      "description": "For a variation of a variable product"
    }
  }
}

{
  "title": "Update WooCommerce stock",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "store_id",
    "product_id"
  ],
  "properties": {
    "store_id": {
      "type": "string"
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "product_id": {
      "type": "string"
    },
    "sale_price": {
      "type": "number"
    },
    "variation_id": {
      "type": "string"
    },
    "regular_price": {
      "type": "number"
    },
    "clear_sale_price": {
      "type": "boolean"
    }
  }
}

{
  "title": "Update WooCommerce price",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "store_id",
    "account_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max WooCommerce products (default 200, cap 500)"
    },
    "store_id": {
      "type": "string"
    },
    "account_id": {
      "type": "string",
      "description": "Amazon outpost (seller × marketplace) from list_clients"
    },
    "lookup_ean": {
      "type": "boolean",
      "description": "Also search unmatched EANs in the Amazon catalog (default false)"
    }
  }
}

{
  "title": "Map WooCommerce products to Amazon",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "store_id"
  ],
  "properties": {
    "days": {
      "type": "number",
      "description": "Window for stock, orders, daily_sales (default 30, max 730)"
    },
    "view": {
      "enum": [
        "products",
        "stock",
        "orders",
        "daily_sales",
        "customers_rfm",
        "sync_status",
        "amazon_mapping"
      ],
      "type": "string",
      "description": "Default products"
    },
    "limit": {
      "type": "number",
      "description": "Max rows (default 200, cap 1000)"
    },
    "store_id": {
      "type": "string",
      "description": "From woo_list_stores"
    }
  }
}

{
  "title": "WooCommerce history (data-hub)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "List connected WordPress sites",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "site_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max posts (default 20, cap 200)"
    },
    "search": {
      "type": "string"
    },
    "status": {
      "enum": [
        "any",
        "draft",
        "pending",
        "publish",
        "future",
        "private",
        "trash"
      ],
      "type": "string"
    },
    "post_id": {
      "type": "string"
    },
    "site_id": {
      "type": "string",
      "description": "From wp_list_sites"
    }
  }
}

{
  "title": "WordPress blog posts",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "site_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max per taxonomy (default 100, cap 500)"
    },
    "search": {
      "type": "string"
    },
    "site_id": {
      "type": "string"
    }
  }
}

{
  "title": "WordPress categories and tags",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "site_id",
    "title",
    "content"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "ISO 8601 publish date (required for future)"
    },
    "slug": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Tag ids from wp_list_terms"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "enum": [
        "draft",
        "pending",
        "publish",
        "future",
        "private"
      ],
      "type": "string",
      "description": "Default draft"
    },
    "content": {
      "type": "string",
      "description": "Post body, HTML"
    },
    "excerpt": {
      "type": "string"
    },
    "site_id": {
      "type": "string"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Category ids from wp_list_terms"
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "featured_media": {
      "type": "integer",
      "description": "Media id already in the WordPress library"
    }
  }
}

{
  "title": "Create WordPress blog post",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "site_id",
    "post_id"
  ],
  "properties": {
    "date": {
      "type": "string"
    },
    "slug": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "title": {
      "type": "string"
    },
    "status": {
      "enum": [
        "draft",
        "pending",
        "publish",
        "future",
        "private"
      ],
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "excerpt": {
      "type": "string"
    },
    "post_id": {
      "type": "string"
    },
    "site_id": {
      "type": "string"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "confirm_id": {
      "type": "string",
      "description": "Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura."
    },
    "featured_media": {
      "type": "integer"
    }
  }
}

{
  "title": "Update WordPress blog post",
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "sql"
  ],
  "properties": {
    "sql": {
      "type": "string",
      "description": "La query SQL di lettura. Una sola istruzione, niente \";\" multipli."
    },
    "max_rows": {
      "type": "integer",
      "description": "Righe massime da restituire (default e tetto: 5000)."
    }
  }
}

{
  "title": "Query data-hub (SQL)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "Health check",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}