Come collegare SportMonks Football a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → SportMonks Football, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

SportMonks Football + Cursor

SportMonks Football API v3: campionati, stagioni, partite e risultati, livescore, classifiche, marcatori, squadre, rose, giocatori, stadi, quote pre-partita e pronostici, con la sintassi di include e filtri di SportMonks. La copertura dipende dal tuo piano SportMonks.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SPORTMONKS_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account SportMonks con un token API. Esiste un piano gratuito con pochi campionati; i piani a pagamento aggiungono campionati e add-on come quote e pronostici.

1. Accedi a my.sportmonks.com e apri API, poi Tokens.
2. Crea un token e copialo.
3. Incolla solo il token in SPORTMONKS_API_TOKEN, senza spazi né il prefisso api_token=. Il connettore lo invia nell'header Authorization.
4. Installa il connettore ed esegui sportmonks_list_my_leagues: elenca i campionati coperti dal tuo piano, con i loro id.

I dati dipendono dal tuo piano: cosa puoi leggere dipende dal tuo piano SportMonks, soprattutto dai campionati inclusi. I dati fuori dal piano non danno errore: la risposta è semplicemente vuota, con una nota che il tuo abbonamento attuale non vi ha accesso. Per questo l'AI parte dai tuoi campionati e lavora con quelli. Quote e pronostici richiedono anche l'add-on corrispondente.

Cosa legge: campionati e stagioni; partite e risultati di un giorno o di un intervallo di date; livescore e partite in corso adesso; classifiche, anche live; marcatori, assist e cartellini; squadre, rose e giocatori con le loro statistiche; precedenti tra due squadre; stadi; quote pre-partita dei bookmaker del tuo piano; e le probabilità e i value bet del modello di SportMonks.

Prima gli id: SportMonks lavora con gli id. Alcuni id di campionato: 8 Premier League, 9 Championship, 82 Bundesliga, 384 Serie A, 564 LaLiga, 301 Ligue 1, 2 Champions League. Classifiche, marcatori e rose richiedono l'id di una stagione, che l'AI prende dalla stagione in corso del campionato. Squadre, giocatori e stadi si trovano per nome con gli strumenti di ricerca.

Include e filtri: una risposta base contiene solo id. L'AI aggiunge i dati collegati con gli include, per esempio participants;scores;state;events.type per una partita con squadre, punteggio, stato e gol, e restringe gli elenchi con filtri come fixtureLeagues:9. Limita gli include a ciò che hai chiesto, perché rendono le risposte molto più grandi. Gli elenchi arrivano in pagine fino a 50 elementi.

Sola lettura: ogni strumento legge soltanto. Nel tuo account SportMonks non cambia nulla, quindi non c'è niente da confermare e nessuno strumento è disattivato all'installazione.

Quote e pronostici sono informazioni: le quote sono decimali. I value bet sono ciò che trova il modello di SportMonks; sono informazioni, non consigli di scommessa.

Orari e intervalli: gli orari arrivano in UTC se l'AI non indica un fuso orario, e ti dà gli orari di inizio nel tuo. Un intervallo di date copre al massimo 100 giorni.

Limiti: SportMonks consente 3.000 chiamate all'ora per entità (partite, squadre, giocatori e così via). Ogni risposta mostra quante chiamate restano e quando il contatore si azzera; dopo un 429 l'AI aspetta l'azzeramento. Preferisce un elenco filtrato a molte chiamate singole.

Errori comuni: 401 significa che SportMonks ha rifiutato il token: creane uno nuovo in API e incollalo di nuovo. 403 significa che il token funziona ma quella risorsa non è nel tuo piano. Una risposta vuota con "No result(s) found" di solito indica che il campionato o l'add-on non è nel tuo piano.

Il connettore copre solo il calcio; non piazza scommesse e non modifica il tuo piano o i tuoi token SportMonks.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di SportMonks Football.

Tool disponibili

Esempi di prompt

• "Mostrami la classifica attuale della Serie A con la forma di ogni squadra nelle ultime cinque partite."
• "Quando gioca l'Inter le prossime cinque partite, e com'erano finite le ultime cinque?"
• "Quali partite si stanno giocando adesso nei miei campionati, e qual è il punteggio?"
• "Chi sono i capocannonieri e i migliori assistman della Serie A in questa stagione?"
• "Cosa dice il modello di SportMonks sul derby di domenica, e quali sono le quote pre-partita di bet365?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT