Guida al connettore8 minuti di lettura29 tool MCP7 lingue

Reverb MCP Server: annunci, ordini e pagamenti

Reverb API per venditori di strumenti musicali: elenchi propri con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

HCA cura del team HelpCodeAggiornato 8 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Reverb

Reverb

Reverb API for sellers of music gear: own listings with draft, update and publish, orders and shipping with tracking, buyer messages, offers, refund requests, payouts and shop data. Personal access token.

tool

29

Regione

INTL

Categoria

E-commerce

Autenticazione

Bearer Token

Env vars richieste

REVERB_TOKEN
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

Reverb API per venditori di strumenti musicali: elenchi propri con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Configurazione guidata

Collega Reverb a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Reverb con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Prova a chiedere

Prompt di esempio per Reverb

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Reverb · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Reverb, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Reverb

Reverb API per venditori di strumenti musicali: elenchi propri con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Configurazione

La configurazione richiede circa 3 minuti.

  1. Accedi a reverb.com, apri il menu utente e vai su Il mio profilo.
  2. Clicca sulla scheda API e integrazioni, poi Genera nuovo token.
  3. Inserisci un nome e seleziona gli ambiti: public, read_listings, write_listings, read_orders, write_orders, read_messages, write_messages, read_offers, write_offers, read_payouts e read_profile. Un strumento il cui ambito è mancante viene rifiutato.
  4. Copia il token in REVERB_TOKEN. I token di accesso personali non scadono.

Reverb richiede a ogni venditore di avere la fatturazione impostata e almeno un elenco creato a mano su reverb.com prima di utilizzare l'API.

Da dove iniziare: reverb_list_orders_awaiting_shipment mostra cosa deve essere spedito. reverb_list_my_listings mostra i tuoi elenchi attivi (stato di tutte le aggiunte, bozze e quelle terminate); reverb_get_shop mostra il negozio e i suoi profili di spedizione.

Elenchi: crea una bozza con reverb_create_listing (uuid della categoria da reverb_list_categories, uuid della condizione da reverb_list_listing_conditions, id del profilo di spedizione da reverb_get_shop), modificala con reverb_update_listing, e mettila in vendita con reverb_publish_listing. reverb_list_my_drafts elenca le bozze non pubblicate e reverb_get_listing legge un elenco. Trova un elenco con il tuo SKU usando reverb_list_my_listings e sku. Solo le condizioni Nuovo di zecca, B-Stock e Mint con inventario possono contenere più di un'unità; un articolo usato è un pezzo singolo e non può essere rimesso in vendita una volta venduto. Impostare l'inventario a 0 termina l'elenco. reverb_end_listing è installato disattivato.

Ordini: reverb_list_orders (tutti, filtra per ultima modifica), reverb_list_orders_awaiting_shipment, reverb_get_order. Spedisci solo quando lo stato è pagato, con reverb_ship_order (fornitore da reverb_list_shipping_providers e il numero di tracciamento); i ritiri locali sono chiusi con reverb_mark_order_picked_up. Le etichette di spedizione non vengono acquistate tramite questo connettore.

Messaggi e offerte: reverb_list_conversations, reverb_get_conversation e reverb_send_message gestiscono i messaggi degli acquirenti. reverb_list_offers e reverb_get_offer leggono le offerte sui tuoi elenchi; reverb_decline_offer rifiuta una. reverb_accept_offer e reverb_counter_offer sono installati disattivati, perché entrambi ti impegnano a un prezzo.

Rimborsi e pagamenti: reverb_list_refund_requests legge le richieste di rimborso. reverb_respond_to_refund_request e reverb_create_refund_request sono installati disattivati: approvare un rimborso accredita l'acquirente e addebita te contemporaneamente. reverb_list_payouts e reverb_list_payout_line_items leggono quanto Reverb ha pagato al tuo conto bancario e le commissioni per ordine.

Formati: il denaro è un oggetto con amount (stringa decimale come 95.00), amount_cents, currency e display; invia importo e valuta. Le date sono in ISO 8601 con un offset. Id: gli ordini usano il numero d'ordine, gli elenchi l'id numerico dell'elenco, le categorie e le condizioni un uuid.

Paging e link: Reverb risponde in HAL JSON. Le liste portano _links.next e _links.prev; quando il prossimo è mancante sei nell'ultima pagina. Usa page e per_page per muoverti. Ogni oggetto elenca anche le azioni aperte a esso sotto _links.

Errori: 401 significa che il token è errato o manca dell'ambito; 404 non trovato; 406 l'azione violerebbe una regola dello stato attuale; 412 un errore di convalida con message e errors per campo; 429 troppe chiamate.

Limiti di frequenza: letture 2.000 al minuto o 10.000 ogni 10 minuti; scritture 600 al minuto o 3.000 ogni 10 minuti. Evita di sincronizzare l'intero negozio tutto in una volta.

Sandbox: sandbox.reverb.com è un sito separato con i propri account e token; questo connettore chiama l'API di produzione.

Prerequisiti: REVERB_TOKEN

Installa il connettore localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Reverb e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

StrumentoCosa fa
reverb_list_my_listingsElenca i tuoi elenchi con il loro id, titolo, marca, modello, sku, condizione, prezzo (importo e valuta), inventario e _links (l'elenco…
reverb_list_my_draftsElenca le tue bozze di elenco (create ma non ancora pubblicate) con gli stessi campi di reverb_list_my_listings: id, titolo, marca, modello, sku…
reverb_get_listingLeggi un elenco per id con i campi da cui è creato un elenco: titolo, marca, modello, finitura, anno, descrizione, condizione, categorie…
reverb_create_listingCrea un elenco come bozza nel tuo negozio Reverb. Non è visibile agli acquirenti fino a quando non viene chiamato reverb_publish_listing. Fornisci almeno un titolo…
reverb_update_listingAggiorna uno dei tuoi elenchi (bozza o attivo): solo i campi forniti cambiano. Usi tipici: prezzo, inventario, descrizione, foto, spedizione…
reverb_publish_listingPubblica un elenco in bozza affinché gli acquirenti possano vederlo e acquistarlo. La bozza deve essere completa (marca e modello noti, categoria, condizione, prezzo, foto…
reverb_end_listingTermina un elenco attivo affinché non possa più essere acquistato. Il motivo not_sold lo rimuove semplicemente. Il motivo reverb_sale indica che hai trovato l'acquirente su…
reverb_list_ordersElenca gli ordini che hai venduto, tutti gli stati: order_number, status (non pagato, pagamento in attesa, in attesa di revisione, bloccato, pagato, spedito, ritirato…
reverb_list_orders_awaiting_shipmentElenca gli ordini pagati che devono ancora essere spediti, con gli stessi campi di reverb_list_orders (order_number, titolo, quantità, nome_acquirente…
reverb_get_orderLeggi un ordine venduto per numero d'ordine: order_number, status (non pagato, pagamento in attesa, in attesa di revisione, bloccato, pagato, spedito, ritirato…
reverb_ship_orderContrassegna un ordine pagato come spedito con il corriere e il numero di tracciamento. Con send_notification true Reverb invia un'email all'acquirente che l'articolo è…
reverb_mark_order_picked_upContrassegna un ordine di ritiro locale come ritirato dall'acquirente (ordini con shipping_method locale). Lo stato dell'ordine diventa picked_up. Usalo solo…
reverb_list_shipping_providersElenca i fornitori di spedizione (corrieri) che Reverb accetta quando un ordine è contrassegnato come spedito. Usa il nome del fornitore esattamente come elencato in…
reverb_list_conversationsElenca le tue conversazioni di messaggi su Reverb, ciascuna con il suo id (necessario per leggerla o rispondere) e _links. Con unread_only true solo…
reverb_get_conversationLeggi una conversazione in dettaglio, con i suoi messaggi in ordine cronologico (dal più vecchio al più recente), così l'intero scambio con l'acquirente può essere…
reverb_send_messageRispondi in una conversazione esistente. L'altra parte riceve il messaggio su Reverb immediatamente e non può essere ritirato, quindi scrivilo come il…
reverb_list_offersElenca le offerte attive (Reverb le chiama negoziazioni) che gli acquirenti hanno fatto sui tuoi elenchi, ciascuna con il suo id per reverb_get_offer e la risposta…
reverb_get_offerLeggi i dettagli di un'offerta (negoziazione) per id: l'elenco su cui si trova, i prezzi offerti finora e il suo stato attuale, con _links a…
reverb_decline_offerRifiuta un'offerta di un acquirente su uno dei tuoi elenchi. La negoziazione termina senza una vendita e il rifiuto non può essere ritirato; nessun prezzo è…
reverb_accept_offerAccetta un'offerta di un acquirente. Questo è vincolante: accetti di vendere l'articolo al prezzo offerto e al prezzo di spedizione, e l'acquirente può pagare subito.…
reverb_counter_offerRispondi a un'offerta di un acquirente con un controfferta: il tuo prezzo e, facoltativamente, un prezzo di spedizione. Un controfferta è vincolante se l'acquirente accetta…
reverb_list_refund_requestsElenca le richieste di rimborso sulle tue vendite, per impostazione predefinita quelle attive (pending_seller_response e conditionally_approved): id, stato, importo…
reverb_respond_to_refund_requestRispondi a una richiesta di rimborso: conditionally_approved (restituirai una volta che l'articolo è tornato; la richiesta rimane aperta), approved (rimborso ora…
reverb_create_refund_requestAvvia un rimborso su uno dei tuoi ordini venduti come venditore, totale o parziale. Viene creato come condizionatamente approvato; il denaro si muove quando il…
reverb_list_payoutsElenca i pagamenti che Reverb ha inviato al tuo conto bancario: per pagamento totale (importo e valuta), created_at, updated_at e _links.line_items…
reverb_list_payout_line_itemsElenca le righe di un pagamento, una per ordine: order_id, sale_date, sale_price, payout_currency e le commissioni addebitate (selling_fee…
reverb_get_shopLeggi il tuo negozio: id, nome, descrizione e shipping_profiles[] (id e nome), i cui id vanno in shipping_profile_id di un elenco. Spedizione…
reverb_list_categoriesElenca tutte le categorie Reverb come un'unica lista piatta con il loro uuid e nome. L'uuid è ciò che le categorie di un elenco prendono. Una lunga lista; alcune…
reverb_list_listing_conditionsElenca le condizioni che il tuo negozio può utilizzare sugli elenchi (Non funzionante, Scarso, Equo, Buono, Molto buono, Eccellente, Mint, B-Stock, Nuovo di zecca): uuid…

Esempi di richieste

  • "Quali ordini Reverb sono in attesa di spedizione?"
  • "Crea un elenco per la mia Gibson Les Paul Standard del 2019 in condizioni Eccellenti a 2.200 USD."
  • "Quali offerte da parte degli acquirenti sono aperte sui miei elenchi?"
  • "Spedisci l'ordine 12345678 con tracciamento UPS 1Z999AA10123456784."
  • "Mostrami i miei pagamenti dell'ultimo mese e i loro dettagli."

Prossimi passi

Questa guida ti è stata utile?

Collega Reverb a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Reverb con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Reverb a ChatGPT via MCP: ordini e pagamenti

API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Connettori

Collegare Reverb a Claude via MCP: annunci e ordini

API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Connettori

Collegare Reverb a Microsoft Copilot via MCP

API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Connettori

Collegare Reverb a Cursor via MCP: annunci e ordini

API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Connettori

Collegare Reverb a Gemini CLI via MCP

API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.

Connettori

Collegare Reverb a Meta Muse via MCP

API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.