ParlayAPI
Odds de apostas esportivas, props de jogadores e dados de mercado de previsão de mais de 45 casas de apostas e fontes em mais de 90 esportes, com ferramentas de veredito, avaliação de parlays, arbitragem, +EV, consenso e middles; 9 das 22 ferramentas funcionam sem chave via uvx parlayapi-mcp (submissão de fundador em primeira mão).
Documentação
parlayapi-mcp
mcp-name: io.github.JacobiusMakes/parlayapi
Servidor MCP para ParlayAPI. Expõe odds esportivas, dados de mercado de previsões, pré-visualizações de dashboard ao vivo, prova de qualidade de fontes e cadastro de agente sem fricção como ferramentas nativas para qualquer cliente compatível com MCP (Claude Desktop, Cursor, OpenClaw, assistentes personalizados).
Por que usar
Sem MCP, um agente que deseja usar a ParlayAPI precisa:
- Pedir ao usuário para se cadastrar via navegador
- Esperar que ele copie e cole a chave
- Construir requisições HTTP manualmente
Com este servidor MCP, o agente pode primeiro chamar ferramentas de descoberta sem chave
como parlayapi_live_command_center() e parlayapi_book_coverage()
para provar que a ParlayAPI está ativa. Se o usuário quiser o feed completo, o agente
chama parlayapi_signup(email) e recebe uma chave de API funcional, URL de
reivindicação para o dashboard e uma URL de upgrade Stripe que o usuário pode clicar.
Em seguida, ele chama parlayapi_get_odds(), parlayapi_get_props(), etc.
diretamente.
Instalar no Claude Desktop (um clique)
Baixe parlayapi-mcp-0.3.5.mcpb e abra-o (clique duas vezes ou arraste-o para o Claude Desktop). O Claude Desktop descompacta o pacote e executa o servidor com seu runtime uv gerenciado, sem necessidade de terminal ou configuração de Python.
O campo de chave de API no diálogo de instalação é opcional. Deixe em branco para
começar sem chave: cadastro, preços, pré-visualizações ao vivo, qualidade de fontes e
ferramentas de cobertura funcionam imediatamente, e a ferramenta parlayapi_signup pode
criar uma chave gratuita (1.000 créditos/mês, sem cartão) sem sair do chat.
Adicione a chave depois a qualquer momento em Configurações, Extensões, ParlayAPI.
O código-fonte do pacote está em mcpb/. Recompile-o com
npx @anthropic-ai/mcpb pack mcpb/.
Instalar (manual, qualquer cliente MCP)
# Quickest path, no venv:
uvx parlayapi-mcp --help
# Or install globally with pip:
pip install parlayapi-mcp
Configurar seu cliente MCP
Claude Desktop
Edite ~/Library/Application Support/Claude/claude_desktop_config.json
no macOS (%APPDATA%\Claude\claude_desktop_config.json no Windows):
{
"mcpServers": {
"parlayapi": {
"command": "uvx",
"args": ["parlayapi-mcp"],
"env": {
"PARLAYAPI_KEY": "your_key_here"
}
}
}
}
Se você ainda não tem uma chave, omita env completamente. A ferramenta de cadastro
funcionará sem chave, assim como as ferramentas públicas de pré-visualização ao vivo, preços,
qualidade de fontes e cobertura. Ferramentas de dados pagos retornarão um
erro informando para você definir uma chave. Após o cadastro, cole sua nova chave em
env e reinicie o Claude Desktop. PARLAY_API_KEY também é aceita para
clientes que usam o estilo com sublinhado.
Cursor
Adicione a .cursor/mcp.json:
{
"mcpServers": {
"parlayapi": {
"command": "uvx",
"args": ["parlayapi-mcp"],
"env": { "PARLAYAPI_KEY": "your_key_here" }
}
}
}
OpenClaw
O OpenClaw pode salvar definições de servidor MCP stdio com openclaw mcp set.
Esta configuração sem chave permite que o assistente use ferramentas de cadastro, preços, pré-visualização
ao vivo, qualidade de fontes e prova de cobertura imediatamente:
openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"]}'
Após o usuário se cadastrar, adicione a chave de API para ferramentas de dados pagos:
openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"],"env":{"PARLAYAPI_KEY":"your_key_here"}}'
Ferramentas expostas
| Ferramenta | Autenticação | Finalidade |
|---|---|---|
parlayapi_signup | nenhuma | Criar uma conta gratuita, retornar chave de API + URL de reivindicação + URL de upgrade |
parlayapi_checkout_link | nenhuma | URL de upgrade Stripe para qualquer plano |
parlayapi_magic_link | nenhuma | Enviar link de login sem senha por e-mail |
parlayapi_get_pricing | nenhuma | Preços públicos atuais e planos de crédito |
parlayapi_live_sports | nenhuma | Eventos esportivos ao vivo ativos, contagem de eventos e contagem de casas |
parlayapi_live_search | nenhuma | Buscar times, jogadores e chaves de esportes ao vivo |
parlayapi_live_command_center | nenhuma | Pré-visualização pública de melhor linha de /live |
parlayapi_source_quality | nenhuma | Metadados públicos de frescor e qualidade de fontes |
parlayapi_book_coverage | nenhuma | Prova pública de cobertura de cinco portões por casa |
parlayapi_list_sports | chave | Todas as chaves de esportes disponíveis |
parlayapi_get_odds | chave | Odds em nível de jogo (h2h, spreads, totais) para um esporte |
parlayapi_get_props | chave | Odds de props de jogadores para um esporte |
parlayapi_best_line | chave | Melhor preço por resultado entre casas de apostas |
parlayapi_verdict | chave | Chamada única "devo apostar nisso?": preço justo vs mercado, melhor casa para apostar, chamada BET/PASS em linguagem simples |
parlayapi_set_bettable_books | chave | Lembrar a região/casas do usuário para que veredictos ignorem casas que ele não pode usar |
parlayapi_parlay_verdict | chave | Avaliar uma aposta múltipla: preço justo combinado, melhor casa para colocá-la, EV, perna mais fraca, avisos de correlação, pagamento |
parlayapi_best_bets | chave | Jogadas +EV ranqueadas para um esporte, limitadas às casas onde você pode apostar, além de alertas de borda |
parlayapi_account_info | chave | Plano, créditos restantes, período de cobrança |
Recursos
parlayapi://docs/quickstart - Exemplos de código em Python e JS.
Desenvolvimento local
git clone https://github.com/JacobiusMakes/ParlayAPI
cd ParlayAPI/mcp-server
pip install -e .
# Run against the local API instead of production:
PARLAYAPI_BASE_URL=http://127.0.0.1:8080 \
PARLAYAPI_KEY=your_local_test_key \
parlayapi-mcp
Licença
MIT