Footix

Servidor MCP Footix

Endpoint JSON-RPC 2.0 sobre HTTP, autenticado por chave Bearer. Compatível com qualquer cliente MCP (Cursor, Claude Desktop, Codex, SDKs oficiais) e utilizável em HTTP puro.

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

1 · Início rápido

1. Insira seu e-mail na página inicial: seu espaço abre imediatamente.
2. Responda às duas perguntas de onboarding.
3. Em Conectar minha IA, clique em "Copiar o prompt".
4. Cole o prompt no seu agente e aceite a solicitação de acesso que aparecer.

O nível Preview é gratuito: 50 requisições por dia, 2 ferramentas, dados com atraso de 24 h.

2 · Fluxo de conexão de um agente

Inspirado no "device authorization grant": o agente nunca obtém uma chave sem seu consentimento explícito no 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_..." }

Status possíveis do polling: authorization_pending, approved, access_denied, expired, already_claimed. Intervalo recomendado: 5 segundos, expiração após 10 minutos.

3 · Chamar uma ferramenta

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 suportados: initialize, tools/list, tools/call, ping. Cada resposta de ferramenta contém um bloco _meta.quota com seu consumo restante.

4 · Catálogo de ferramentas

Ferramenta	Descrição	Nível mínimo

5 · Cotas e níveis

O contador é redefinido à meia-noite UTC. Excedente: a ferramenta retorna uma resposta isError explícita em vez de um erro de transporte, para que seu agente possa lê-la.

6 · Erros

Código	Significado	O que fazer
401 / -32001	Chave ausente, inválida ou revogada	Reinicie o fluxo /api/mcp/connect/start
-32601	Método JSON-RPC desconhecido	Verifique o nome do método
-32602	Ferramenta desconhecida	Chame tools/list
isError (ferramenta)	Cota atingida ou ferramenta fora do nível	Aguarde a redefinição ou mude de nível
403	Solicitação de conexão recusada pelo usuário	Não tente novamente automaticamente
503	Serviço de cobrança não configurado	Tente novamente mais tarde

7 · Segurança

• As chaves são armazenadas com hash (SHA-256): nem a Footix nem seus operadores podem reexibir uma chave existente.
• Cada chave é revogável instantaneamente pelo seu espaço; a revogação tem efeito na próxima requisição.
• Cada aceitação ou recusa de conexão é registrada com data e hora no seu registro de atividades.
• O pagamento passa inteiramente pelo Stripe: nenhum dado bancário transita pelos nossos servidores.

A Footix fornece dados e probabilidades estatísticas para fins informativos. Não é um conselho de aposta.