Serveur MCP Footix

1 · Démarrage rapide

1. Entre ton email sur la page d'accueil : ton espace s'ouvre immédiatement.
2. Réponds aux deux questions d'onboarding.
3. Dans Connecter mon IA, clique sur « Copier le prompt ».
4. Colle le prompt à ton agent, puis accepte la demande d'accès qui s'affiche.

Le palier Preview est gratuit : 50 requêtes par jour, 2 outils, données différées de 24 h.

2 · Flux de connexion d'un agent

Inspiré du « device authorization grant » : l'agent n'obtient jamais de clé sans ton accord explicite dans le navigateur.

# 1. l'agent demande l'accès
curl -X POST https://footix.org/api/mcp/connect/start \
  -H 'content-type: application/json' \
  -d '{"client_name":"Cursor"}'

# → { "device_code": "...", "user_code": "ABCD-2345",
#     "verification_uri_complete": "https://footix.org/connect?code=ABCD-2345" }

# 2. l'utilisateur ouvre l'URL et accepte (ou refuse)

# 3. l'agent récupère sa clé, une seule fois
curl -X POST https://footix.org/api/mcp/connect/poll \
  -H 'content-type: application/json' \
  -d '{"device_code":"..."}'

# → { "status": "approved", "api_key": "fx_live_..." }

Statuts possibles du polling : authorization_pending, approved, access_denied, expired, already_claimed. Intervalle recommandé : 5 secondes, expiration au bout de 10 minutes.

3 · Appeler un outil

curl -X POST https://footix.org/mcp \
  -H 'authorization: Bearer fx_live_…' \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "simulate_match", "arguments": { "match_id": "90112" } }
  }'

Méthodes supportées : initialize, tools/list, tools/call, ping. Chaque réponse d'outil contient un bloc _meta.quota avec ta consommation restante.

4 · Catalogue d'outils

5 · Quotas et paliers

Le compteur se réinitialise à minuit UTC. Dépassement : l'outil renvoie une réponse isError explicite plutôt qu'une erreur de transport, pour que ton agent puisse la lire.

6 · Erreurs

7 · Sécurité

• Les clés sont stockées hachées (SHA-256) : ni Footix ni ses opérateurs ne peuvent réafficher une clé existante.
• Chaque clé est révocable instantanément depuis ton espace ; la révocation prend effet à la requête suivante.
• Chaque acceptation ou refus de connexion est horodaté dans ton journal d'activité.
• Le paiement passe entièrement par Stripe : aucune donnée bancaire ne transite par nos serveurs.