Servidor MCP oficialServidor MCP da Odds API
para o seu assistente de IA
Conecte o Claude, Codex, Cursor ou VS Code a odds ao vivo e históricas de 450+ casas de apostas. Peça preços, movimentação de linhas, value bets ou resultados de apostas com suas próprias palavras, ou deixe o assistente escrever o código.
Gratuito e open source · 33 ferramentas · npm, Docker e instalação em um clique no Claude Desktop
Conectado em menos de um minuto
Obtenha uma chave de API
Escolha um plano e suas casas de apostas. Sua chave aparece no painel assim que o pagamento é aprovado.
Adicione o servidor à sua ferramenta de IA
Cole um comando ou um bloco JSON. O servidor roda na sua própria máquina com npx ou Docker e lê a chave de uma variável de ambiente.
Pergunte com suas palavras
Seu assistente escolhe as ferramentas certas, chama a API e responde com preços ao vivo. Ele também pode escrever e testar código com os mesmos dados.
claude mcp add odds-api \
--env ODDS_API_KEY="your-api-key" \
-- npx -y odds-api-mcp-servercodex mcp add odds-api \
--env ODDS_API_KEY="your-api-key" \
-- npx -y odds-api-mcp-server{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"servers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"mcpServers": {
"odds-api": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ODDS_API_KEY",
"oddsapi/odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}Usa o Claude Desktop? Baixe o arquivo .mcpb da versão mais recente e abra. O Claude pede sua chave e faz o resto.
O que você pode perguntar
Perguntas reais, respondidas com dados ao vivo. Abaixo de cada uma estão as ferramentas que o assistente chama para responder.
Quais jogos da Premier League deste fim de semana têm a maior diferença entre Bet365 e Unibet no resultado final?
get_eventsget_multi_oddsComo a odd de Mais de 2,5 gols em Arsenal x Chelsea se moveu na Bet365 desde ontem?
search_eventsget_odds_movementsQuais odds da NBA estão caindo mais rápido hoje à noite?
get_dropping_oddsListe as value bets da Betano agora, ordenadas por valor esperado.
get_value_betsOntem apostei no Liverpool -1 handicap asiático e em Mais de 2,5 gols no jogo deles pela Premier League. As apostas ganharam?
get_historical_eventsgrade_betsEscreva um script em Python que envie uma mensagem no Telegram quando surgir uma arbitragem acima de 2% entre as minhas casas de apostas.
get_documentationget_arbitrage_bets
33 ferramentas, a API inteira
As ferramentas cobrem toda a API v3, então tudo o que o assistente encontra no chat funciona do mesmo jeito no seu código.
Odds
get_odds- Todos os mercados de um evento em até 30 casas de apostas
get_multi_odds- Odds de até 10 eventos em uma única chamada
get_updated_odds- Só as odds que mudaram desde um timestamp
get_odds_summary- Preço melhor, médio, pior e justo por linha entre as casas
get_odds_movements- Histórico de preços de uma linha em uma casa de apostas
get_dropping_odds- Linhas que mais caíram desde a abertura, por esporte e liga
Eventos
get_events- Jogos por esporte, liga, time, data ou status
get_event- Um evento pelo id
get_live_events- Todos os eventos ao vivo neste momento
search_events- Encontre um evento pelo nome do time
Ferramentas de apostas
get_value_bets- Preços com valor esperado positivo em uma casa de apostas
get_arbitrage_bets- Oportunidades de arbitragem entre as suas casas de apostas
Histórico e liquidação
get_historical_events- Eventos encerrados por esporte, liga e data
search_historical_events- Encontre um evento encerrado pelo nome do time
get_historical_odds- Odds de fechamento e placar final de um evento encerrado
get_closing_lines- Linhas de fechamento de até 10 ligas de uma vez
get_settlements- Status e placar final por período de até 50 eventos
grade_bets- Liquide até 50 apostas como ganhas, perdidas, anuladas ou meio resultado
Outrights de golfe
list_outrights- Torneios por circuito, com quantas casas cotam cada um
get_outright_odds- Odds de vencedor, Top 5/10/20 e passar o corte de um torneio
get_outright_results- Posições finais e vencedores de cada mercado
Referência
get_sports- Todos os esportes e seus slugs
get_leagues- Ligas de um esporte com a contagem de eventos
get_markets- Nomes exatos dos mercados por esporte, pré-jogo e ao vivo
get_bookmakers- Todas as casas de apostas e se estão ativas
get_participants- Times e jogadores de um esporte
get_participant- Um time ou jogador pelo id
get_mappings- Os ids próprios de uma casa para nossos eventos e seleções
Sua conta e a documentação
get_selected_bookmakers- As casas de apostas do seu plano
select_bookmakers- Adicione casas de apostas à sua seleção
clear_selected_bookmakers- Redefina sua seleção, uma vez a cada 12 horas
get_usage- Seu limite por hora, requisições restantes e horário de renovação
get_documentation- A documentação completa da API, para o código funcionar de primeira
Roda na sua máquina e lê a API ao vivo
Sua chave fica na sua máquina
O servidor roda localmente via stdio e fala direto com api.odds-api.io. Não há nada no meio, e a chave fica na sua configuração MCP.
Os mesmos dados da API
450+ casas de apostas e 34 esportes, pré-jogo e ao vivo, em um único schema JSON. O que o assistente vê é o que o seu código vai receber.
Documentação que o assistente consegue ler
O servidor traz a documentação completa e a especificação OpenAPI como recursos MCP. Quando você pede código, o assistente confere primeiro os nomes reais dos campos.
Incluído em todos os planos
O servidor MCP é gratuito e open source. As chamadas de ferramentas são requisições normais à API e contam nas suas 5.000 requisições/hora.
Perguntas sobre o servidor MCP
O que é o servidor MCP da Odds API?
É o servidor oficial de Model Context Protocol da Odds-API.io. Ele dá a assistentes de IA como Claude, Codex e Cursor 33 ferramentas para ler odds ao vivo e históricas, eventos, value bets, arbitragem e resultados de apostas de 450+ casas de apostas.
Com quais ferramentas de IA ele funciona?
Com qualquer cliente que suporte MCP via stdio. Isso inclui Claude Code, Claude Desktop, Codex, Cursor, VS Code com GitHub Copilot, Windsurf e Zed. O Claude Desktop também tem um arquivo de instalação em um clique.
Preciso de um plano pago?
Sim. O servidor precisa de uma chave de API, e as chaves vêm com todos os planos pagos, a partir do Solo por £49/mês com 2 casas de apostas. O servidor MCP em si não custa nada a mais.
Quais casas de apostas meu assistente consegue ver?
As casas selecionadas no seu plano. Peça ao assistente para rodar get_selected_bookmakers para vê-las. Dados de referência, como esportes, ligas e eventos, estão disponíveis para todas as casas.
Funciona com odds ao vivo?
Sim. get_live_events lista os jogos em andamento e get_odds retorna os preços atuais. Para um feed em streaming no seu próprio app, use a API WebSocket. O assistente pode escrever esse código para você.
Minha chave de API está segura?
O servidor roda no seu computador e envia a chave apenas para api.odds-api.io. Não existe proxy hospedado. O código é open source no GitHub sob a licença MIT.
O assistente pode fazer apostas?
Não. O servidor só lê dados. Ele não consegue entrar em uma casa de apostas nem fazer uma aposta.
Qual a diferença para a documentação em llms.txt?
O llms.txt dá ao assistente a documentação para ele escrever código. O servidor MCP permite que ele chame a API e trabalhe com dados ao vivo enquanto você conversa. A maioria das pessoas usa os dois.
Dê odds ao vivo ao seu assistente
Todos os planos incluem o servidor MCP, 5.000 requisições/hora e todos os esportes e mercados. Pague mensal ou anualmente e cancele em qualquer mês.