MCP servercom.vendooly/vendooly

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 Pr

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.

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 entra

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 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 q

Create SP negative keywords

Create SP negative product targets. Each: { campaign_id, ad_group_id, asin (or raw expression) }.

Create SP product ads

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

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). IRREVERSI

Delete SP negative keywords

Delete (archive) SP negative product targets

Delete (archive) SP product targets

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

List Amazon Ads portfolios (groups of campaigns with optional shared budget)

List Amazon Ads profiles for this account

Read-only: elenco ad group Sponsored Brands (SB) — id, nome, stato (ENABLED|PAUSED|ARCHIVED), campagna di appartenenza. Filtra con campaign_id_filter.

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/a

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/v

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

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_filte

LIVE: campagne Sponsored Display (SD) ESISTENTI — name, campaignId, state (enabled|paused|archived), budget giornaliero, tactic (T00020 contestuale | T00030 audiences), costType (c

Read-only list of Sponsored Products ad groups (id, name, state, default bid)

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). sourc

LIVE: stato corrente delle campagne SP. Campi chiave per campagna: name, campaignId, state, targetingType (AUTO|MANUAL) e daily_budget = budget giornaliero NUMERICO nella valuta de

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.

List SP negative keywords

List SP negative product targets

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: cont

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

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

Aggiorna un ad group Sponsored Brands (SB) ESISTENTE (es. stato ENABLED|PAUSED). NON crea ad group nuovi.

Aggiorna una o PIÙ campagne Sponsored Brands (SB) ESISTENTI: budget giornaliero, stato (ENABLED|PAUSED) e OTTIMIZZAZIONE DELL'OFFERTA. Per ottimizzare senza tagliare volume NON str

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_ke

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.

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 OTT

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 pe

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

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

Update a SP ad group

Imposta i MOLTIPLICATORI PER SEGMENTO DI PUBBLICO di UNA campagna Sponsored Products (dynamicBidding.shopperCohortBidding): aggiunge o modifica (set=[{audience_id, percentage}]), t

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|PAUSE

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,

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.

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

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.

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

Run catalog quality audit

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_inform

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 gi

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: dele

Bulk inventory updates

Bulk listing attribute updates (title, bullet_point, any patch). updates: [{sku, title?, bullets?: string[], patches?: [...], product_type?, validate_only?}]. Use when you need to

Bulk price updates

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

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

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 regi

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

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 de

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, descripti

Delete a listing

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

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

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 UNRECONCIL

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 pe

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" = opzio

Vendor Central OAuth link

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

Read-only aggregated KPI summary across all accounts in the org (aggregates only, no customer data)

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_cont

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,

Live SP-API catalog item lookup

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

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, wheth

Get a built-in documentation topic by name (see list_context_topics).

Read-only aggregated KPI summary for this account (listing counts, 7d revenue total, issue count). Aggregates only, no customer data.

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_REPOR

READ-ONLY. Detailed physical FBA customer returns from GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA: SKU, ASIN, return date, quantity, original reason, detailed_disposition, status, f

FBA inventory summaries

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,

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

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'o

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/upd

Fetch one listing (summaries, issues, offers, fulfillment availability). Pass include_data:["attributes"] for the full attribute set.

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 bl

Catalog detail from local cache

Your own pricing per SKU

Items for a specific order

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 r

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

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 rima

Vendor PO aggregate summary

Vendor PO details

Vendor POs

Vendor: importi stimati dai PO (SP-API non espone remittance reali in lettura)

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 Vend

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 è vis

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.

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-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 d

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

Healthcheck

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

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 —

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 frust

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

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 alcu

Modifica una listing esistente. SHORTCUT amichevoli (consigliati — costruiscono la struttura attributo corretta, niente schema SP-API a mano): bullets:[...] → bullet_point ("Funzio

Update MFN inventory quantity for a SKU

Update price for a SKU

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