Ghiduri de integrare

Datele de loterie, direct în asistentul tău AI.

Conectează Claude, Cursor, VS Code sau propriul agent la serverul MCP Lottevo și lasă-l să citească direct rezultatele, istoricul, statisticile și verificatorul de bilete.

API-ul Lottevo este și un server Model Context Protocol. Un client MCP conectat la el poate căuta un joc, îi poate citi ultimele rezultate și istoricul, îi poate clasa numerele și poate verifica un bilet — fără să scrii tu o integrare. Răspunde cu aceleași date ca /v1, cu aceeași cheie, același plan și aceleași cote.

Conectare

Setare	Valoare
URL	`https://api.lottevo.com/mcp`
Transport	Streamable HTTP
Autentificare	cheia ta de API, ca `Authorization: Bearer lv_…` (sau `X-Api-Key`)

Claude Code

Exemplu de cod

claude mcp add --transport http lottevo https://api.lottevo.com/mcp \
  --header "Authorization: Bearer lv_a1b2c3d4e5f6_…"

Cursor, VS Code și alți clienți cu configurare JSON — numele cheilor diferă puțin de la un client la altul (mcpServers sau servers, url, headers):

Exemplu de cod

{
  "mcpServers": {
    "lottevo": {
      "url": "https://api.lottevo.com/mcp",
      "headers": { "Authorization": "Bearer lv_a1b2c3d4e5f6_…" }
    }
  }
}

Claude Desktop se conectează la serverele la distanță prin OAuth, pe care acest server nu îl folosește încă, așa că ajunge la el prin mcp-remote:

Exemplu de cod

{
  "mcpServers": {
    "lottevo": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.lottevo.com/mcp", "--header", "Authorization: Bearer ${LOTTEVO_API_KEY}"],
      "env": { "LOTTEVO_API_KEY": "lv_a1b2c3d4e5f6_…" }
    }
  }
}

Serverul se autentifică cu o cheie API, nu cu OAuth, așa că un client care se poate conecta doar printr-o autentificare OAuth nu îl poate folosi încă.

Dă-i asistentului o cheie a lui: el doar citește, deci îi ajung permisiunile de citire, iar cheia se poate revoca fără să-ți atingi integrarea.

Unelte

Unealtă	La ce răspunde	Necesită
`search_lotteries`	Găsește un joc după nume sau cod, după țară, stat american sau continent	`catalog:read`
`get_lottery`	Un joc: reguli, șanse de câștig, prețul biletului, program, următorul jackpot, tabel de plăți, ultimele rezultate	`catalog:read`
`get_latest_results`	Ultimul rezultat al fiecărui joc, opțional într-o singură țară	`draws:read`
`get_draw_history`	Rezultatele trecute ale unui joc, între două date	`draws:read`
`get_draw`	Un rezultat cu toate categoriile de premii	`draws:read`
`get_lottery_statistics`	Numerele, perechile și tripletele cele mai extrase, cele mai rar extrase și cele absente de cel mai mult timp	`statistics:read`
`get_lottery_distributions`	Cum s-au distribuit extragerile — sume, pare/impare, mici/mari, vecine, poziții, pauze — lângă o extragere corectă, cu un test de aleatorietate	`statistics:read`
`check_ticket`	Ce extrageri trecute a nimerit un bilet și cât ar fi câștigat	`draws:read` și un plan cu verificatorul de bilete
`generate_tickets`	Bilete valide și diferite sub filtre — pare/impare, intervale, sume, neieșite, numere calde sau reci — cu câte permit filtrele	`statistics:read`
`build_wheel`	Un sistem redus pe numerele alese: bilete care garantează un număr de potriviri ori de câte ori destule dintre numerele extrase sunt printre ele	`statistics:read`

Un client vede doar uneltele pe care cheia lui le poate apela: unei chei fără statistics:read sau pe un plan fără verificatorul de bilete nu i se oferă acele unelte.

Cote și limite

Fiecare apel de unealtă e o cerere către endpoint-ul pe care îl citește — get_lottery este GET /v1/lotteries/{code} — și se scade din cota zilnică la fel ca oricare alta. Apare în jurnalul de cereri din panoul tău sub acel endpoint, cu user agentul lottevo-mcp. Conectarea și listarea uneltelor nu costă nimic, dar respectă limita pe minut a cheii.

Tot ce limitează cheia se aplică și aici: jocurile pe care le acoperă, cât de departe ajunge istoricul planului tău, data de expirare și revocarea.

Erori

Un apel de unealtă refuzat se întoarce ca eroare de unealtă, al cărei text e chiar JSON-ul API-ului — cu același code ca la Erori, de exemplu lottery_not_entitled, history_not_included sau quota_exceeded cu retry_after. O cheie lipsă, necunoscută sau revocată e refuzată la conectare, cu 401.