Footix

Servidor MCP Footix

Endpoint JSON-RPC 2.0 sobre HTTP, autenticado mediante clave Bearer. Compatible con cualquier cliente MCP (Cursor, Claude Desktop, Codex, SDK oficiales) y utilizable en HTTP puro.

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

1 · Inicio rápido

1. Introduce tu correo electrónico en la página de inicio: tu espacio se abre inmediatamente.
2. Responde las dos preguntas de incorporación.
3. En Conectar mi IA, haz clic en «Copiar el prompt».
4. Pega el prompt en tu agente y acepta la solicitud de acceso que aparece.

El nivel Preview es gratuito: 50 solicitudes por día, 2 herramientas, datos con 24 h de retraso.

2 · Flujo de conexión de un agente

Inspirado en la «concesión de autorización de dispositivo»: el agente nunca obtiene una clave sin tu consentimiento explícito en el navegador.

# 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_..." }

Estados posibles del sondeo: authorization_pending, approved, access_denied, expired, already_claimed. Intervalo recomendado: 5 segundos, expiración a los 10 minutos.

3 · Llamar a una herramienta

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étodos admitidos: initialize, tools/list, tools/call, ping. Cada respuesta de herramienta contiene un bloque _meta.quota con tu consumo restante.

4 · Catálogo de herramientas

Herramienta	Descripción	Nivel mínimo

5 · Cuotas y niveles

El contador se restablece a medianoche UTC. Excedente: la herramienta devuelve una respuesta isError explícita en lugar de un error de transporte, para que tu agente pueda leerla.

6 · Errores

Código	Significado	Qué hacer
401 / -32001	Clave ausente, inválida o revocada	Reinicia el flujo /api/mcp/connect/start
-32601	Método JSON-RPC desconocido	Verifica el nombre del método
-32602	Herramienta desconocida	Llama a tools/list
isError (herramienta)	Cuota alcanzada o herramienta fuera de nivel	Espera el restablecimiento o cambia de nivel
403	Solicitud de conexión rechazada por el usuario	No reintentar automáticamente
503	Servicio de facturación no configurado	Reintenta más tarde

7 · Seguridad

• Las claves se almacenan con hash (SHA-256): ni Footix ni sus operadores pueden volver a mostrar una clave existente.
• Cada clave es revocable al instante desde tu espacio; la revocación surte efecto en la siguiente solicitud.
• Cada aceptación o rechazo de conexión queda con marca de tiempo en tu registro de actividad.
• El pago se realiza íntegramente a través de Stripe: ningún dato bancario pasa por nuestros servidores.

Footix proporciona datos y probabilidades estadísticas con fines informativos. No es un consejo de apuestas.