All servers · Marketing & SEO

Vendooly

com.vendooly/vendooly · v1.0.2

Measured by MCP Station

Description written by the publisher, not verified

Amazon Seller Central, Ads and Vendor Central in ChatGPT & Claude. 106 tools; writes need approval.

Connect

claude mcp add --transport http vendooly https://mcp.vendooly.com/mcp

{
  "mcpServers": {
    "vendooly": {
      "url": "https://mcp.vendooly.com/mcp"
    }
  }
}

Tools as reported by the server

• list_clients
  List the connected Amazon outposts (an outpost = one seller on one marketplace; the account_id of each is what you pass to other tools). Org-scoped.
• get_client_status
  Get status/details of the selected Amazon seller account (outpost), including the Amazon Ads connection: ads.ads_status and, for Ads consents granted from 30/7/2026, ads.expires_at / ads.days_left (Amazon expires Ads consent 365 days after it is granted, then Ads stop working until the seller reconn
• get_fba_inventory
  FBA inventory summaries
• fba_inbound_discrepancies
  READ-ONLY. "Check FBA shipments and show me the discrepancies / what to recover": reads the inventory ledger (Receipts) which gives, per shipment, units received and the UNRECONCILED quantity that Amazon itself flags (potential loss), plus an estimated recoverable value (× listing price); and cross-
• fba_reimbursement_check
  READ-ONLY. "How many FBA units did I lose / got damaged, and how many were NOT reimbursed?" — the FBA lost & damaged balance per SKU (what ZoneWizard logistics, Igolai, Getida do). Reads the inventory ledger (Adjustments: lost M/5, found F/N, damaged E/6, other damage H/K/7/U, disposed D) and the re
• get_fulfilled_shipments
  READ-ONLY. FBA orders as physically fulfilled by Amazon (report Amazon Fulfilled Shipments, GENERAL variant — no buyer PII): per order, the fulfillment-center-id each item shipped FROM and the derived ship-from country. Use when the user needs to know FROM WHICH COUNTRY an FBA order departed — typic
• get_inbound_plans
  READ-ONLY. List FBA inbound plans (new "Send to Amazon" workflow, Fulfillment Inbound v2024-03-20): inbound plan id, name, status (ACTIVE/SHIPPED/VOIDED), marketplaces, created/updated. This is the API that sees shipments created with the current Amazon flow (the legacy get_inbound_shipments v0 retu
• create_inbound_plan
  ACTION. Crea un PIANO di spedizione FBA ("Send to Amazon", Fulfillment Inbound v2024-03-20): SKU + quantità + indirizzo di ORIGINE (magazzino/fornitore del seller). È il PASSO 1 del flusso: il piano nasce come bozza modificabile, NON parte nessuna spedizione. SEQUENZA COMPLETA (guida l'utente passo-
• get_inbound_plan
  READ-ONLY. Dettaglio di UN piano inbound FBA v2024 (stato, indirizzo origine, righe SKU con quantità/prep/label). Con operation_id (invece di inbound_plan_id) fa il polling di un'operazione asincrona pendente (create/generate/confirm) e ne ritorna stato + problemi. Per l'ELENCO dei piani usa get_inb
• generate_inbound_options
  ACTION (bozze non vincolanti). Genera E elenca in una sola chiamata le opzioni del piano inbound FBA: kind:"packing" = opzioni di imballo (packing groups); kind:"placement" = opzioni di DESTINAZIONE con split tra centri Amazon e FEE per opzione (inbound placement fee vs Amazon-optimized) — mostra SE
• confirm_inbound_option write/delete
  ACTION. Conferma un'opzione del piano inbound FBA scelta dall'utente. kind:"packing" + packing_option_id = fissa l'imballo (poi servono le scatole: set_packing_information). kind:"placement" + placement_option_id = IMPEGNO VERO: le spedizioni vengono CREATE con lo split e le fee di quell'opzione (ri
• set_packing_information write/delete
  ACTION. Registra le SCATOLE del piano inbound FBA (dopo il packing confermato): per ogni packing group, le scatole con dimensioni in CM, peso in KG, quantità di scatole identiche e contenuto (SKU+quantità per scatola, salvo content_source diverso). Passo obbligatorio PRIMA di generare le opzioni di
• cancel_inbound_plan write/delete
  ACTION. Annulla un piano inbound FBA v2024 non ancora spedito (torna VOIDED). Usalo per i ripensamenti su un piano creato per errore o non più necessario. Chiedi conferma esplicita all'utente prima di chiamare.
• update_mfn_quantity write/delete
  Update MFN inventory quantity for a SKU
• check_feed_status
  Stato di elaborazione di un feed (es. quelli restituiti da bulk_delete_listings). Amazon lavora i feed in modo asincrono: IN_QUEUE/IN_PROGRESS = ancora in corso, richiama fra un po'. Quando è DONE la risposta porta GIÀ l'esito letto: `summary` con quante righe Amazon ha processato/accettato/rifiutat
• get_orders
  List individual orders (last N days): order ids, status, dates and totals only — no buyer data. Live Amazon Orders API, throttled (≈1 req/min): use ONLY when you need order-level rows. For daily sales/orders charts or trends over a period use get_daily_sales; for a single revenue total use get_reven
• get_order_items
  Items for a specific order
• get_fba_customer_returns
  READ-ONLY. Detailed physical FBA customer returns from GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA: SKU, ASIN, return date, quantity, original reason, detailed_disposition, status, fulfillment center and customer_comments. Use for damaged returns (DAMAGED_BY_FC/DAMAGED_BY_CARRIER), incompatibility (NO
• fiscal_transactions_export
  READ-ONLY. Fiscal transactions file for the accountant (VAT/OSS support): one row per order item for sales (VENDITA), refunds (RIMBORSO), A-to-Z claims and chargebacks, with Amazon posted date, marketplace, order id, SKU, quantity, currency, ship-to country, B2B flag (Amazon Business order), net pri
• get_epr_report
  READ-ONLY. Amazon EPR (Extended Producer Responsibility) report for one seller outpost and one CLOSED calendar period, from SP-API GET_EPR_MONTHLY_REPORTS / GET_EPR_QUARTERLY_REPORTS / GET_EPR_ANNUAL_REPORTS (Product Listing role, sellers only). Returns a summary per ship-to country and EPR category
• audit_catalog_quality
  Run catalog quality audit
• create_listing write/delete
  Crea/sostituisce una listing (PUT). product_data accetta campi SEMPLICI auto-mappati nel formato attributi SP-API: title, brand, price, quantity, condition, ean/upc/gtin, description, bullets[]. Per agganciare un'offerta a un ASIN GIA' a catalogo usa requirements:"LISTING_OFFER_ONLY" + asin (NON ser
• update_listing write/delete
  Modifica una listing esistente. SHORTCUT amichevoli (consigliati — costruiscono la struttura attributo corretta, niente schema SP-API a mano): bullets:[...] → bullet_point ("Funzionalità principali", la leva dei punti-elenco su amazon.it/EU, fino a 5 ~100 char l'uno), title → item_name, shipping_tem
• get_listing
  Fetch one listing (summaries, issues, offers, fulfillment availability). Pass include_data:["attributes"] for the full attribute set.
• delete_listing write/delete
  Delete a listing
• bulk_delete_listings write/delete
  Cancella offerte IN BLOCCO su un account, filtrando per canale di gestione. USA QUESTO, non delete_listing in ciclo, quando le offerte da eliminare sono più di qualche decina: delete_listing va SKU per SKU e sul rate limit di Amazon migliaia di SKU non finiscono mai, mentre qui si spediscono in feed
• search_catalog
  Search the Amazon catalog. IMPORTANT: use identifiers (ASIN/EAN/ISBN) for reliable, compact results. Keyword search returns up to 10 items (summaries only) and may be incomplete — prefer identifiers when you know the ASIN or EAN.
• get_product_types
  Get product type definition. product_type is REQUIRED (e.g. PUZZLE, SAFETY_AND_HEALTH, LUGGAGE). By default fetches the JSON Schema server-side and returns allowed enum values per attribute (attribute_enums) + required_attributes — no need to open the S3 link. The schema is personalised for the sele
• list_my_products
  List own products from local cache (SKU, ASIN, title, price, stock FBA+MFN, fulfillment channel, velocity = avg units/day last 30d, days_cover = stock/velocity — paginated, default 50 rows, no customer data). Use velocity/days_cover for stock-out risk ("sells 3.2/day, runs out in ~4 days"). Filter c
• get_my_catalog_detail
  Catalog detail from local cache
• get_catalog_item
  Live SP-API catalog item lookup
• get_competitive_pricing
  READ-ONLY. Buy Box / Featured Offer price per ASIN (max 20 per Amazon call, auto-batched). Returns buy_box_price (listing) + buy_box_landed_price (incl. shipping), condition, whether you win the Buy Box, and source. Falls back to live offers when Amazon has no competitive price, so it returns far fe
• get_buybox_prices
  READ-ONLY. BULK Buy Box / Featured Offer export for a LIST of ASINs (up to 100). Returns a clean table per ASIN: buy_box_price (all-in for the customer), lowest_price, offer_count, whether you win the Buy Box, FBA/FBM of the winner, and a reason when there is no Buy Box (suppressed / no offers). Use
• get_my_pricing
  Your own pricing per SKU
• get_fee_estimate
  Estimate Amazon fees (referral + FBA + variable closing) and net proceeds for a given selling price, via the official Amazon Product Fees API (getMyFeesEstimate). Pass asin OR sku, the price, currency and fulfillment_channel (FBA default, or FBM). Returns referral_fee, fba_fee, closing_fee, total_fe
• update_price write/delete
  Update price for a SKU
• bulk_update_prices write/delete
  Bulk price updates
• bulk_update_inventory write/delete
  Bulk inventory updates
• bulk_update_listings write/delete
  Bulk listing attribute updates (title, bullet_point, any patch). updates: [{sku, title?, bullets?: string[], patches?: [...], product_type?, validate_only?}]. product_type is optional: each SKU's product type is read from its listing (results[].product_type_used). Use when you need to update titles
• bulk_set_shipping_template write/delete
  Assegna lo STESSO modello di spedizione (merchant_shipping_group) a molti SKU in una volta, con un feed JSON_LISTINGS_FEED (fino a 5.000 SKU per chiamata, un feed) invece di update_listing SKU per SKU. shipping_template = ID o nome come in Seller Central (elenco: get_product_types product_type="PROD
• get_account_health
  READ-ONLY. Account Health of ONE seller account on ONE marketplace (outpost), read from Amazon's official seller performance report (GET_V2_SELLER_PERFORMANCE_REPORT, same data as Seller Central → Account Health): seller account status (NORMAL/AT_RISK/DEACTIVATED), Account Health Rating status (GREA
• check_listing_restrictions
  READ-ONLY. Gated products: BEFORE listing or buying stock, tells whether THIS seller account can sell each ASIN on the outpost's marketplace (or other marketplaces of the same region) in a given condition, using Amazon's Listings Restrictions API (getListingsRestrictions). Per ASIN: libero (no restr
• get_listing_issues
  READ-ONLY. Issue Amazon di SKU SPECIFICI (una chiamata SP-API per SKU): usalo quando l'utente nomina 1-20 SKU. Per la domanda "quali dei miei articoli NON sono in vendita / sono bloccati / soppressi e perché" NON usare questo in loop: usa list_inactive_listings, che copre tutto il catalogo con una c
• list_inactive_listings
  READ-ONLY. Elenco CATALOGO-WIDE dei listing che NON sono in vendita, CON IL MOTIVO — la risposta a "quali prodotti sono inattivi/bloccati/soppressi?", "cosa mi ha bloccato Amazon dopo il caricamento?", "perché questo articolo non si vende?". Legge lo stato reale della Listings Items API (BUYABLE / D
• audit_title_compliance
  Audit all listings for Amazon title limit (75 chars, enforced from July/August 2026 — i titoli non conformi vengono RISCRITTI dall'IA di Amazon, solo i brand registrati hanno 14 giorni di review). Returns titles over the limit with excess character count + bullet/highlight counts per SKU, più la fas
• plan_title_seo_fix
  Titolo conforme SENZA perdere SEO, passo 1 (solo lettura): per ogni SKU accorcia il titolo a 72 caratteri (o usa new_titles), calcola le parole di ricerca perse e le ricolloca in generic_keyword (≤250 byte, niente doppioni); quello che non entra va come frase presa pari pari dal titolo vecchio in co
• apply_title_seo_batch write/delete
  Titolo-SEO, passo 2 (SCRITTURA): applica un lotto del piano (solo SKU ready). Primo lotto dell'outpost max 2 SKU, poi max 50; prima di ogni lotto rilegge il precedente e si ferma se non risulta applicato. Ogni SKU viene riletto dal vivo: se la listing è cambiata dall'anteprima non si scrive. Salva i
• title_seo_status
  Titolo-SEO: stato per l'outpost (ultimo piano con i conteggi, ultimi lotti con esito, verificato, annullabile).
• title_seo_rollback write/delete
  Titolo-SEO (SCRITTURA): rimette titolo, generic_keyword, bullet e descrizione com'erano prima di un lotto, dal registro.
• audit_compliance
  Audit compliance/GPSR del catalogo (EU/IT). Per ogni SKU verifica gli attributi compliance REALI del suo product type (schema-aware): manufacturer, rtip_manufacturer_contact_information (contatto fabbricante), country_of_origin, safety_warning, safety_data_sheet_url e — dove il product type li preve
• update_item_highlights write/delete
  Update Item Highlights on a listing. L'attributo UFFICIALE è title_differentiation (max 125 char, rollout titoli modulari 27/7/2026); item_highlights è il nome legacy visto su alcuni schema US — il tool risolve da solo quale espone lo schema del product type e scrive su quello. ATTENZIONE: non tutti
• audit_aplus_coverage
  READ-ONLY. Copertura A+ Content del catalogo: quali ASIN hanno un documento A+ APPROVED (= visibile al cliente) e quali no, con i buchi ORDINATI per peso commerciale (unità vendute a 30 giorni) — quindi "quali pagine che vendono davvero sono senza A+". Segnala anche i documenti REJECTED (lavoro già
• list_aplus_documents
  READ-ONLY. Elenco dei documenti A+ Content del seller su questo marketplace, con stato (DRAFT | SUBMITTED | APPROVED | REJECTED), badge e data di aggiornamento. Solo APPROVED è visibile al cliente. Per la domanda "quanto del mio catalogo ha A+" usa audit_aplus_coverage, non questo.
• get_aplus_document
  READ-ONLY. Dettaglio di UN documento A+ (stato, badge, ASIN associati, tipi di modulo). content_reference_key si prende da list_aplus_documents o audit_aplus_coverage. include_content=true restituisce anche i moduli completi. NB: i moduli A+ sono TIPIZZATI (STANDARD_TEXT, STANDARD_COMPARISON_TABLE,
• get_dashboard_data
  Read-only aggregated KPI summary for this account (listing counts, 7d revenue total, issue count). Aggregates only, no customer data.
• get_all_dashboards
  Read-only aggregated KPI summary across all accounts in the org (aggregates only, no customer data)
• generate_vendor_oauth_link
  Vendor Central OAuth link
• get_vendor_purchase_orders
  Vendor POs
• get_vendor_purchase_order_details
  Vendor PO details
• get_vendor_po_summary
  Vendor PO aggregate summary
• get_vendor_invoices
  Vendor invoices — SP-API non espone un endpoint di lettura per le fatture vendor retail (solo POST submitInvoices). Questo tool restituisce una spiegazione della limitazione e rimanda a get_vendor_remittances per gli importi stimati e a Vendor Central per le fatture reali.
• get_vendor_remittances
  Vendor: importi stimati dai PO (SP-API non espone remittance reali in lettura)
• ads_list_profiles
  List Amazon Ads profiles for this account
• ads_list_portfolios
  List Amazon Ads portfolios (groups of campaigns with optional shared budget)
• ads_create_portfolio
  Create an Amazon Ads portfolio to group campaigns (no portfolio-level budget cap; campaigns can then be assigned to it). Same scope as campaigns — no extra authorization needed.
• ads_list_sp_campaigns
  LIVE: stato corrente delle campagne SP. Campi chiave per campagna: name, campaignId, state, targetingType (AUTO|MANUAL) e daily_budget = budget giornaliero NUMERICO nella valuta del marketplace (es. 50, 150). NON esiste un "bid" a livello campagna (i bid sono su keyword/target). Usa per VERIFICARE p
• ads_create_sp_campaign
  Create a SP campaign. campaign.targeting_type: "AUTO" (Amazon sceglie automaticamente i target — NON aggiungere keyword/target manuali; per modulare i bid dei 4 gruppi auto usa ads_create_sp_product_targets con auto_match) oppure "MANUAL" (default; poi attacchi keyword via ads_create_sp_keywords o A
• ads_update_sp_campaign write/delete
  Aggiorna una o PIÙ campagne SP. SINGOLA: campaign_id + patches (patches.daily_budget numero → convertito nel payload v3 budget{budgetType:DAILY,budget}; patches.state ENABLED|PAUSED; patches.placement_bidding = MOLTIPLICATORI per placement [{placement, percentage 0-900}] con placement PLACEMENT_TOP|
• ads_list_sp_audiences
  READ-ONLY. Elenca i SEGMENTI DI PUBBLICO utilizzabili per i moltiplicatori di bid delle campagne Sponsored Products (audience bid adjustments, disponibili in IT/DE/FR/ES/UK). source: "amazon" (default: pubblici costruiti da Amazon, es. chi ha già comprato dal brand, chi ha cliccato o messo nel carre
• ads_update_sp_audience_bidding write/delete
  Imposta i MOLTIPLICATORI PER SEGMENTO DI PUBBLICO di UNA campagna Sponsored Products (dynamicBidding.shopperCohortBidding): aggiunge o modifica (set=[{audience_id, percentage}]), toglie (remove=[audience_id]) o azzera tutto (clear_all=true). percentage = aumento % del bid, INTERO 0-900: i segmenti p
• ads_delete_sp_campaign write/delete
  Archivia (elimina) una o più campagne SP. È l'UNICO modo di archiviare una campagna: ads_update_sp_campaign accetta solo ENABLED|PAUSED (Amazon rifiuta ARCHIVED sul PUT). IRREVERSIBILE — una campagna archiviata non si riattiva, va ricreata. campaign_ids: [id, ...].
• ads_list_sp_ad_groups
  Read-only list of Sponsored Products ad groups (id, name, state, default bid)
• ads_create_sp_ad_group
  Create a SP ad group in an existing campaign. Defaults to PAUSED so it can be populated before delivery. IMPORTANTE — un ad group è O keyword-targeted O product-targeted, MAI entrambi: Amazon RIFIUTA (otherError) una keyword in un ad group che ha già product target, e viceversa. Quindi se ti servono
• ads_update_sp_ad_group write/delete
  Update a SP ad group
• ads_list_sb_campaigns
  LIVE: stato corrente delle campagne Sponsored Brands (SB) ESISTENTI (create da Amazon Ads console — Vendooly non crea ancora campagne SB nuove, serve brandEntityId/Brand Registry/asset creativi/moderazione, non implementato). Campi chiave: name, campaignId, state (ENABLED|PAUSED|ARCHIVED), daily_bud
• ads_update_sb_campaign write/delete
  Aggiorna una o PIÙ campagne Sponsored Brands (SB) ESISTENTI: budget giornaliero, stato (ENABLED|PAUSED) e OTTIMIZZAZIONE DELL'OFFERTA. Per ottimizzare senza tagliare volume NON strozzare il budget: usa i moltiplicatori per posizionamento con patches.bid_adjustments_by_placement=[{placement, percenta
• ads_list_sb_ad_groups
  Read-only: elenco ad group Sponsored Brands (SB) — id, nome, stato (ENABLED|PAUSED|ARCHIVED), campagna di appartenenza. Filtra con campaign_id_filter.
• ads_update_sb_ad_group write/delete
  Aggiorna un ad group Sponsored Brands (SB) ESISTENTE (es. stato ENABLED|PAUSED). NON crea ad group nuovi.
• ads_list_sb_keywords
  LIVE: keyword Sponsored Brands (SB) con BID e stato ATTUALI — la lettura da fare prima di riofferire su SB. Filtra con campaign_id/ad_group_id. NON ritorna performance: per spesa/vendite/ACoS usa execute_sql su fact_keyword_daily. Elenco vuoto = quel brand non ha keyword SB (tipico se le campagne SB
• ads_update_sb_keyword_bid write/delete
  Aggiorna il BID di una o PIÙ keyword Sponsored Brands. È la leva per OTTIMIZZARE una campagna SB invece di spegnerla o strozzarne il budget. keyword_id si ottiene da ads_list_sb_keywords. SINGOLA: keyword_id + bid. BATCH (consigliato): items=[{keyword_id, bid}], MAX 25. Esito verificato per-id (read
• ads_update_sb_keyword_state write/delete
  Aggiorna lo stato (ENABLED|PAUSED|ARCHIVED) di una o PIÙ keyword Sponsored Brands. SINGOLA: keyword_id + state. BATCH: items=[{keyword_id, state}], MAX 25. Esito verificato per-id.
• ads_list_sb_targets
  LIVE: product target Sponsored Brands (ASIN/categoria/brand) con BID e stato ATTUALI. Il target_id serve per ads_update_sb_target_bid. NON ritorna performance: usa execute_sql sul data-hub. Elenco vuoto = nessun target SB su questo profilo: dillo, NON inventare target.
• ads_update_sb_target_bid write/delete
  Aggiorna il BID di uno o PIÙ product target Sponsored Brands. Insieme a ads_update_sb_keyword_bid e ai moltiplicatori per posizionamento di ads_update_sb_campaign è il modo per OTTIMIZZARE SB (invece di limitarsi a spegnere o tagliare il budget). target_id da ads_list_sb_targets. SINGOLA: target_id
• ads_update_sb_target_state write/delete
  Aggiorna lo stato (ENABLED|PAUSED|ARCHIVED) di uno o PIÙ product target Sponsored Brands. SINGOLA: target_id + state. BATCH: items=[{target_id, state}], MAX 25. Esito verificato per-id.
• ads_list_sd_campaigns
  LIVE: campagne Sponsored Display (SD) ESISTENTI — name, campaignId, state (enabled|paused|archived), budget giornaliero, tactic (T00020 contestuale | T00030 audiences), costType (cpc|vcpm), bidOptimization. Vendooly non CREA campagne SD (servono audiences/creatives/Brand Registry): legge e aggiorna
• ads_update_sd_campaign write/delete
  Aggiorna una o PIÙ campagne Sponsored Display ESISTENTI: budget giornaliero e/o stato (enabled|paused). SINGOLA: campaign_id + daily_budget/state. BATCH: items=[{campaign_id, daily_budget?, state?}], MAX 25. Esito verificato per-id (read-after-write). NON crea campagne SD.
• ads_list_sd_ad_groups
  Read-only: ad group Sponsored Display — id, nome, stato, campagna di appartenenza e defaultBid (l'offerta dell'ad group, la leva di ottimizzazione SD). Filtra con campaign_id_filter.
• ads_update_sd_ad_group write/delete
  Aggiorna uno o PIÙ ad group Sponsored Display: BID (defaultBid) e/o stato (enabled|paused). Su SD il bid dell'ad group è la leva principale di ottimizzazione. SINGOLA: ad_group_id + bid/state. BATCH: items=[{ad_group_id, bid?, state?}], MAX 25. Esito verificato per-id.
• ads_list_sp_keywords
  LIVE: keyword SP con bid e stato ATTUALI — per agire o verificare. NON ritorna performance: per spesa/vendite/ACoS o keyword che sprecano usa execute_sql su fact_keyword_daily.
• ads_create_sp_keywords
  Create SP keywords. L'ad group bersaglio deve essere keyword-targeted: se ha GIÀ product target Amazon rifiuta con otherError (un ad group è keyword O product, mai entrambi) → in quel caso crea un ad group dedicato alle keyword. Ogni keyword: { campaign_id, ad_group_id, keyword_text, match_type (BRO
• ads_update_sp_keyword_bid write/delete
  Aggiorna il bid di una o PIÙ keyword SP. SINGOLA: keyword_id + bid. BATCH (consigliato per agire su molte keyword in una volta — meno chiamate, niente raffica): items=[{keyword_id, bid}], ogni keyword può avere un bid diverso, MAX 25 per chiamata. Esito verificato PER-ID (read-after-write).
• ads_update_sp_keyword_state write/delete
  Aggiorna lo stato (ENABLED/PAUSED) di una o PIÙ keyword SP. SINGOLA: keyword_id + state. BATCH: items=[{keyword_id, state}], MAX 25 per chiamata. Esito verificato PER-ID.
• ads_list_sp_negative_keywords
  List SP negative keywords
• ads_create_sp_negative_keywords
  Create SP negative keywords
• ads_delete_sp_negative_keywords write/delete
  Delete SP negative keywords
• ads_list_sp_product_ads
  READ-ONLY LIVE. Elenco SP completo di default (all_pages=true), con ASIN/SKU, stato, nomi e stati di campagna e gruppo. Filtri esatti. all_pages=false legge una pagina Amazon: continuare con next_token anche se vuota dopo i filtri ASIN/SKU. Per trovare tutti gli ASIN scoperti usare ads_catalog_cover
• ads_catalog_coverage
  READ-ONLY. Tutti gli ASIN del catalogo e delle vendite recenti di un outpost, uno per uno, con SKU, titolo, stock, vendite e copertura Sponsored Products LIVE. Incrocia tutte le Product Ads e gli stati campagna/gruppo. Nessun campionamento; dati incompleti o obsoleti producono errore, mai falsi scop
• ads_update_sp_product_ad_state write/delete
  Mette in pausa o riattiva (ENABLED/PAUSED) uno o PIÙ product ad SP, cioè il singolo ASIN/SKU sponsorizzato dentro un ad group, senza toccare campagna o ad group. ad_id da ads_list_sp_product_ads. ARCHIVED non è ammesso (irreversibile). SINGOLA: ad_id + state. BATCH: items=[{ad_id, state}], MAX 25 pe
• ads_create_sp_product_ads
  Create SP product ads
• ads_list_sp_targets
  List SP targeting clauses — SIA i target MANUAL (ASIN/categoria) SIA i 4 gruppi AUTO che Amazon genera da solo nelle campagne AUTO. Ogni clause ritorna il suo targetId, lo state e (se impostato) il bid. Mappatura gruppi AUTO (expression.type → nome UI): QUERY_HIGH_REL_MATCHES=close-match, QUERY_BROA
• ads_create_sp_product_targets write/delete
  Create SP targets. MANUAL (campagne MANUAL): ogni target { campaign_id, ad_group_id, bid, e uno tra: asin (ASIN target), category_id (category target), expression (raw v3) }. AUTO (campagne AUTO): per impostare il bid sui 4 gruppi di matching automatico usa { campaign_id, ad_group_id, bid, auto_matc
• ads_update_sp_target_bid write/delete
  Aggiorna il bid di uno o PIÙ target SP (MANUAL ASIN/categoria o i 4 gruppi AUTO close/loose/substitutes/complements). Il target_id si ottiene da ads_list_sp_targets; è QUESTA (non ads_create_*) la via per modulare i bid dei gruppi auto su una campagna AUTO già esistente. SINGOLA: target_id + bid. BA
• ads_update_sp_target_state write/delete
  Aggiorna lo stato (ENABLED/PAUSED) di uno o PIÙ target SP. SINGOLA: target_id + state. BATCH: items=[{target_id, state}], MAX 25. Esito verificato per-id.
• ads_delete_sp_targets write/delete
  Delete (archive) SP product targets
• ads_list_sp_negative_targets
  List SP negative product targets
• ads_create_sp_negative_targets write/delete
  Create SP negative product targets. Each: { campaign_id, ad_group_id, asin (or raw expression) }.
• ads_delete_sp_negative_targets write/delete
  Delete (archive) SP negative product targets
• get_vendor_trading_terms
  Vendor trading terms — SP-API non espone termini commerciali (payment terms, sconti, accordi) in lettura. Questo tool restituisce una spiegazione della limitazione e rimanda a Vendor Central e a get_vendor_remittances per i netCost per PO.
• weekly_recap
  READ-ONLY operational recap, aggregates only (no customer data): revenue, orders, FBA/FBM split, account health and top products by sales velocity. Use when the user asks "how did it go", "recap", "how am I doing".
• diagnose_sales_drop
  Diagnose a sales drop: compares the last N days with the previous period, checks account health and returns likely causes plus suggested actions. Use for "why are my sales dropping?".
• reprice_to_buybox write/delete
  ACTION. Reprices the given SKUs to win the Buy Box: compares your price with the Buy Box price and proposes a new one (`delta` below the Buy Box, never below `floor`). With confirm=false it returns a PREVIEW (before→after); with confirm=true it applies the prices. ALWAYS show the preview and get the
• ads_get_budget_usage
  READ-ONLY, LIVE. Quanto del budget GIORNALIERO ogni campagna ha già consumato OGGI, in percentuale (dato INTRAGIORNALIERO, aggiornato da Amazon ogni ~10-15 min). Serve alla domanda "quali campagne stanno per restare senza budget adesso / sono già andate dark?": a 100% la campagna esce dall'asta fino
• ads_stockout_check
  READ-ONLY. Cross-references catalog days of cover (30d cached velocity) with active SP product ads: finds where you are paying for clicks on products close to stock-out. Use for "am I wasting ads budget?", "are ads pushing products that are running out?".
• findings_list
  READ-ONLY. Problemi operativi rilevati OGNI GIORNO dal motore deterministico Vendooly sul Data-Hub (i numeri vengono dal motore dati, non dall'LLM). Regole: buybox_lost (Buy Box persa su ASIN che vendono), buybox_suppressed (Buy Box soppressa), stockout_risk (copertura reale FBA sotto soglia, merce
• ads_performance
  READ-ONLY, DETERMINISTICO. Performance Ads dal Data-Hub con numeri calcolati dal server, SEMPRE uguali a parità di dati: finestre FISSE di 7/14/30 giorni chiuse 3 giorni prima dell'ultimo dato (attribuzione Amazon ancora incompleta), ACoS/CTR/CVR/CPC/RPC/AOV dalle somme SQL, confronto con il periodo
• list_context_topics
  List built-in documentation topics (guides and recipes for using Vendooly tools correctly: write confirmation flow, catalog cache fields, rate limits, multi-account, cross analyses). Read the relevant guide BEFORE an operation you are not familiar with.
• get_context_document
  Get a built-in documentation topic by name (see list_context_topics).
• list_sops
  List the standard operating procedures (SOP) saved in the user's Vendooly organization: title, schedule, number of steps, outposts it applies to. Use it to answer "what do we do every day/week" or before running a procedure. Max 10 active SOP per organization.
• get_sop
  Read one SOP with all its steps (from list_sops → id). Follow the steps in order when the user asks to run the procedure.
• save_sop
  Create (without sop_id) or update (with sop_id) a SOP of the user's organization. Owners/admins only. steps = ordered list of {title, body?, role?} (max 40). outpost_ids = the outposts it applies to (from list_clients; omit = all). status=archived archives it, status=active restores it. Max 10 activ
• list_cockpits
  List the cockpits of the user's organization (a cockpit = a group of outposts watched together with monthly sales targets and a traffic light). Max 10 active per organization.
• get_cockpit
  Cockpit for a calendar month: for each outpost the month-to-date sales (VAT included, from the Vendooly data-hub), the month target, the end-of-month projection, Ads ACoS/TACoS, open findings (stock-outs, blocked listings, Ads on out-of-stock items) and a traffic light rosso/giallo/grigio/verde with
• save_cockpit
  Create (without cockpit_id) or update a cockpit of the user's organization. Owners/admins only. outpost_ids from list_clients (omit = all outposts). status=archived / active. Max 10 active cockpits.
• set_cockpit_target write/delete
  Set the monthly sales target of one outpost (seller × marketplace) for a calendar month. Owners/admins only. vat says whether the target is VAT included (inclusa, default, same basis as the data) or excluded (esclusa: the cockpit then flags it yellow because it compares different bases). status: pro
• invite_team_member
  Invite a colleague to the user's OWN Vendooly organization (the one of this connection — you cannot choose another). Use when the user says "invite this person to my account/team". Only owners/admins can invite. `role` is admin (sees every seller) or member (sees only the sellers listed in `seller_i
• list_team_members
  List the people of the user's Vendooly organization (role, status, assigned sellers, per-function permissions) and the seller ids that can be assigned to a member. Owners/admins only.
• send_feedback write/delete
  Send the user's feedback (a bug, an idea, a question or a general comment) straight to the Vendooly team — they read every one. Use it whenever the user reports a problem, is frustrated, hits an error, or suggests something. ALSO proactively OFFER to send it when something clearly is not working ("v
• execute_sql
  Esegue UNA query SQL di sola lettura sul data-hub storico dell'account (DuckDB, un file per org). È LA STRADA PRIMARIA per OGNI domanda di ANALYTICS, in particolare la PERFORMANCE Amazon Ads: ACoS, ROAS, spesa, click, impression, vendite/ordini per campagna o keyword, keyword che sprecano, campagne
• ping
  Healthcheck

Tool changes

• 2026-10-24: list_clients, get_client_status, get_fba_inventory, fba_inbound_discrepancies, fba_reimbursement_check, get_fulfilled_shipments, get_inbound_plans, create_inbound_plan, get_inbound_plan, generate_inbound_options, confirm_inbound_option, set_packing_information
• 2026-10-23: list_clients, get_client_status, get_fba_inventory, fba_inbound_discrepancies, fba_reimbursement_check, get_fulfilled_shipments, get_inbound_plans, create_inbound_plan, get_inbound_plan, generate_inbound_options, confirm_inbound_option, set_packing_information
• 2026-10-21: list_clients, get_client_status, get_fba_inventory, fba_inbound_discrepancies, fba_reimbursement_check, get_fulfilled_shipments, get_inbound_plans, create_inbound_plan, get_inbound_plan, generate_inbound_options, confirm_inbound_option, set_packing_information
• 2026-10-16: list_clients, get_client_status, get_fba_inventory, fba_inbound_discrepancies, fba_reimbursement_check, get_fulfilled_shipments, get_inbound_plans, create_inbound_plan, get_inbound_plan, generate_inbound_options, confirm_inbound_option, set_packing_information

Website · JSON · Text for agents · Registry updated 2026-10-07