Footix

Serveur MCP Footix

Endpoint JSON-RPC 2.0 sur HTTP, authentifié par clé Bearer. Compatible avec tout client MCP (Cursor, Claude Desktop, Codex, SDK officiels) et utilisable en HTTP brut.

POST https://footix.org/mcp protocole 2025-06-18

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

Outil	Description	Palier minimum

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

Code	Signification	Que faire
401 / -32001	Clé absente, invalide ou révoquée	Relance le flux /api/mcp/connect/start
-32601	Méthode JSON-RPC inconnue	Vérifie le nom de méthode
-32602	Outil inconnu	Appelle tools/list
isError (outil)	Quota atteint ou outil hors palier	Attends la réinitialisation ou change de palier
403	Demande de connexion refusée par l'utilisateur	Ne pas réessayer automatiquement
503	Service de facturation non configuré	Réessaie plus tard

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.

Footix fournit des données et probabilités statistiques à titre informatif. Ce n'est pas un conseil de pari.