Servizio MCP di Salsa Vida


Collega un assistente AI o un’applicazione agli elenchi pubblici di eventi di salsa e bachata e alle guide alle destinazioni di Salsa Vida. Il Model Context Protocol (MCP) offre ai client compatibili un modo standard per cercare queste informazioni e inserire un link alla fonte.

Connessione

Endpoint: https://mcp.salsavida.com/mcp
Trasporto: Streamable HTTP
Autenticazione: Nessuna. Accesso pubblico in sola lettura.

Aggiungi questo URL come server MCP remoto in un client compatibile. Autorizza i suoi quattro strumenti in sola lettura quando richiesto. I client decidono a quali server connettersi e quando utilizzarli. Disporre di un endpoint MCP non collega automaticamente Salsa Vida a ogni chatbot.

Per Codex CLI:

codex mcp add salsa-vida --url https://mcp.salsavida.com/mcp

Per Claude Code:

claude mcp add --transport http salsa-vida https://mcp.salsavida.com/mcp

Nelle applicazioni che supportano connettori personalizzati, apri le impostazioni dei connettori e aggiungi l’endpoint indicato sopra. La disponibilità e i requisiti dell’account dipendono dal client. La presenza nelle directory e le relative verifiche sono separate dalle connessioni dirette.

Strumenti disponibili

  • search_locations: Trova una città, una regione o un paese, con il relativo identificativo stabile della località e il contesto geografico.
  • search_events: Trova eventi per località, date, ballo, tipo di evento, stile di salsa e lingua.
  • get_event: Consulta i dettagli essenziali di un evento e le sue occorrenze programmate in un intervallo di date.
  • get_guide: Consulta il riepilogo di una guida a una destinazione già esistente e i suoi link a Salsa Vida.

Usa il meccanismo di individuazione degli strumenti per ottenere gli schemi di input e output aggiornati. Risolvi le ambiguità nei nomi dei luoghi prima di cercare. Se più destinazioni hanno lo stesso nome, preferisci un identificativo stabile della località.

Esempi di domande

  • Quali social di salsa sono elencati a San Francisco nelle prossime due settimane?
  • Trova lezioni di bachata a Tokyo e inserisci i link ai dettagli.
  • Quali festival sono in programma in Spagna durante le date del mio viaggio?
  • Mostrami la guida di Salsa Vida per Parigi, Francia.
  • Quando è previsto questo evento ricorrente e quali informazioni restano sconosciute?

Copertura e interpretazione

Il servizio comprende le località pubbliche di Salsa Vida, gli eventi in programma che soddisfano i criteri di inclusione e le guide esistenti a città, regioni e paesi di tutto il mondo. Le date degli eventi sono ricercabili in un periodo mobile di un anno. Per impostazione predefinita, le ricerche coprono i prossimi 14 giorni. La risposta indica l’intervallo esatto delle date indicizzate. I profili degli insegnanti, gli articoli, Dancepedia e le ricerche private non rientrano in questa versione.

L’intervallo di date predefinito inizia dalla data corrente del calendario UTC. Per «oggi» o «stasera», specifica esplicitamente le date del calendario locale dell’utente. L’indice conserva anche una data precedente per includere le località in cui la data locale è ancora il giorno prima rispetto alla data UTC. Le date non implicano un fuso orario se la fonte non ne ha indicato uno.

Le risposte includono i titoli disponibili, descrizioni sintetiche, sede e indirizzo, date, orari noti, classificazioni, prezzi pubblicati e link a Salsa Vida. Le informazioni mancanti restano sconosciute. Vengono usate le traduzioni pubblicate, ove disponibili; in alternativa viene fornita la versione inglese, segnalando esplicitamente questa scelta. Un evento tradotto condivide gli stessi identificativi dell’evento originale e delle sue occorrenze.

I filtri per stile di salsa usano soltanto le classificazioni registrate. Molte schede non hanno ancora una classificazione di stile, quindi una ricerca senza risultati con questo filtro non dimostra che lo stile non sia disponibile nella destinazione.

Le date ricorrenti sono programmate secondo la ricorrenza registrata. Non costituiscono una dichiarazione che l’organizzatore abbia confermato ogni singola occorrenza. I festival di più giorni vengono raggruppati in un’unica occorrenza dell’evento. La data e l’ora di sincronizzazione indicano quando il nostro indice è stato controllato o aggiornato, non quando un organizzatore ha verificato un evento. Consulta la pagina dell’evento su Salsa Vida e le informazioni dell’organizzatore prima di pianificare un viaggio.

Aggiornamento e disponibilità

Il servizio controlla le modifiche alla fonte circa ogni cinque minuti. Le risposte indicano la data e l’ora dei controlli della fonte. Dopo 15 minuti senza un controllo viene segnalato un ritardo; dopo un’ora lo stato viene indicato come degradato, e dopo 24 ore senza un controllo riuscito i risultati degli eventi non vengono più forniti. Un errore di sincronizzazione produce un errore del servizio, non una falsa indicazione dell’assenza di eventi.

Il servizio è gratuito. I limiti regolabili di utilizzo ed elaborazione tutelano la disponibilità e i costi operativi. Se raggiungi un limite, riprova più tardi oppure visita direttamente Salsa Vida. Le richieste pubbliche non vengono mai inoltrate alle ricerche sull’istanza WordPress del sito in produzione.

Limiti di utilizzo

I limiti iniziali sono di circa 120 chiamate agli strumenti al minuto per indirizzo IP di rete, 20 risultati per impostazione predefinita, 50 per pagina e fino a 10 pagine per ricerca. Le richieste sono limitate a 16 KB e le risposte a 128 KB. La paginazione e il troncamento sono indicati esplicitamente. Restringi le ricerche troppo ampie quando i risultati vengono troncati. Le reti condivise possono condividere lo stesso limite. I limiti possono cambiare in risposta alla domanda o agli abusi.

Usa la normale gestione degli errori MCP e rispetta le indicazioni sui nuovi tentativi. Evita tentativi ripetuti a breve distanza, la replica in massa e i tentativi di aggirare i limiti di accesso.

Attribuzione e visite

Quando usi i risultati di Salsa Vida, indica Salsa Vida come fonte e includi il link all’evento o alla guida pertinente. Ogni risultato fornisce un URL canonico senza parametri e un URL di visita con tag. Usa l’URL canonico per citare la fonte e l’URL di visita per un’azione facoltativa «Visualizza su Salsa Vida». Non presentare informazioni incomplete o ricorrenti come verificate in modo indipendente.

Le chiamate agli strumenti non dimostrano che un assistente abbia citato un risultato o che una persona abbia visitato il sito web. Il link di visita con tag ci aiuta a misurare separatamente le visite osservabili.

Privacy

Registriamo misurazioni d’uso sintetiche: strumento, identificativi geografici selezionati, brevi ricerche di nomi di luoghi normalizzati, ballo, stile di salsa, tipo di evento, lingua, orizzonte di pianificazione, numero di risultati, tempo di risposta, errori, stato della cache e nome dichiarato dal client. I nomi dei client non sono verificati. Nelle analisi del prodotto non memorizziamo conversazioni complete, corpi completi delle richieste o delle risposte, né indirizzi IP grezzi. Gli indirizzi di rete possono essere elaborati temporaneamente per applicare limiti contro gli abusi.

Cloudflare ospita il servizio e ne elabora le analisi. Le analisi dettagliate degli strumenti vengono conservate per un massimo di tre mesi e gli aggregati giornalieri per 25 mesi. Il campionamento del fornitore può rendere i conteggi delle stime. I link con tag usano le normali analisi del sito web secondo l’Informativa sulla privacy di Salsa Vida.

Se ti connetti tramite Smithery, il suo gateway può fungere da intermediario per le richieste a Salsa Vida. La connessione è soggetta anche alle politiche di privacy e utilizzo di Smithery; l’endpoint diretto indicato sopra non richiede Smithery.

Condizioni d’uso e assistenza

Il servizio ha lo scopo di aiutare le persone a scoprire eventi di ballo e destinazioni. L’accesso pubblico non autorizza a ripubblicare l’intero database di Salsa Vida o a riprodurre su larga scala descrizioni protette. Rispetta l’attribuzione della fonte, i limiti pubblicati e i Termini di servizio di Salsa Vida. Le informazioni sugli eventi possono cambiare e la disponibilità non è garantita.

Per domande sull’integrazione, correzioni o problemi di accesso, contatta Salsa Vida. Includi il nome dello strumento, l’ora approssimativa della richiesta e una descrizione del problema priva di informazioni sensibili. Non inviare conversazioni private o credenziali.