ParlayAPI

parlayapi-mcp

mcp-name: io.github.JacobiusMakes/parlayapi

Servidor MCP para ParlayAPI. Expõe odds esportivas, dados de mercado de previsões, prévias de painel ao vivo, prova de qualidade de fontes e cadastro de agente sem atrito 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 pelo 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, uma URL de resgate para o painel e uma URL de upgrade do Stripe que o usuário pode clicar. Em seguida, ele chama parlayapi_get_odds(), parlayapi_get_props(), etc. diretamente.

Instalar no Claude Desktop

Abra o último lançamento para desktop e baixe o arquivo que termina em -directory.mcpb. As notas do lançamento identificam a versão do pacote e a validação realizada. Abra o arquivo baixado (duplo clique, ou arraste-o para o Claude Desktop). O Claude Desktop descompacta o pacote e executa o servidor com seu runtime gerenciado de uv, então não é necessário configurar terminal ou Python.

O pacote Python 0.3.8 encaminha uma chave de conta disponível para validação de propriedade no checkout e distingue uma URL de checkout de um reconhecimento de fluxo por e-mail. Um reconhecimento não confirma a entrega do e-mail. O pacote de desktop 0.3.6, fixado separadamente, não inclui essa correção de checkout. Verifique a página de lançamentos acima para pacotes de desktop mais recentes.

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évias 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)

# Start the stdio server (normally launched by your MCP client):
uvx --from parlayapi-mcp==0.3.8 parlayapi-mcp

# Or install globally with pip:
pip install parlayapi-mcp==0.3.8

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évia 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

Para a integração empacotada, veja Configuração do plugin Cursor.

Adicione em .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évia 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"}}'

Executar localmente com Docker

Compile o contêiner stdio a partir deste repositório:

docker build -t parlayapi-mcp:local .
docker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges parlayapi-mcp:local

O processo aguarda mensagens MCP na entrada padrão. Ele não abre um servidor web nem faz uma chamada de API apenas ao iniciar. Conecte-o por meio de um cliente MCP; não use -t, que alocaria um terminal em vez do transporte stdio do MCP.

Para ferramentas de conta, configure sua própria PARLAYAPI_KEY na configuração secreta do seu cliente MCP e passe essa variável de ambiente para o contêiner:

docker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges -e PARLAYAPI_KEY parlayapi-mcp:local

Nenhuma chave é embutida na imagem. Cada usuário deve configurar sua própria chave e manter as respostas da conta dentro do seu próprio cliente. Este contêiner não é um feed comunitário compartilhado. A licença de software MIT não concede direitos de distribuição de dados; os Termos aplicáveis e qualquer acordo escrito regem o uso dos dados da API. Esses padrões do contêiner não alteram acordos existentes.

Ferramentas públicas de descoberta não precisam de chave. Ferramentas de conta usam sua franquia; verifique planos e limites atuais. O conjunto de ferramentas existente também inclui criação de conta, criação de link de checkout, e-mail de link de login e preferências de apostas salvas. Aprove essas ações explicitamente no seu cliente MCP. Listar ferramentas em si não cria conta, não envia e-mail e não inicia checkout.

Para relatórios de segurança privados, envie um e-mail para support@parlay-api.com. Não coloque chaves de API ou respostas de conta em issues públicas.

Ferramentas expostas

Ferramenta	Autenticação	Finalidade
parlayapi_signup	nenhuma	Criar uma conta gratuita, retornar chave de API + URL de resgate + URL de upgrade
parlayapi_checkout_link	nenhuma	URL de upgrade do Stripe para qualquer plano
parlayapi_magic_link	nenhuma	Enviar por e-mail um link de login sem senha
parlayapi_get_pricing	nenhuma	Preços públicos atuais e níveis de crédito
parlayapi_live_sports	nenhuma	Esportes ao vivo ativos, contagens de eventos e contagens de casas
parlayapi_live_search	nenhuma	Buscar times, jogadores e chaves de esportes ao vivo
parlayapi_live_command_center	nenhuma	Prévia 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 APOSTAR/PASSAR em linguagem simples
parlayapi_set_bettable_books	chave	Lembrar a região/casas do usuário para que os 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 classificadas para um esporte, limitadas às casas onde você pode apostar, além de alertas de margem
parlayapi_account_info	chave	Nível, créditos restantes, período de cobrança
parlayapi_find_arbitrage	chave	Candidatos a arbitragem entre casas, mercados de 3 vias (casa/empate/fora) incluídos
parlayapi_find_ev	chave	Apostas de EV positivo vs. linha justa sem vig de uma casa afiada
parlayapi_consensus	chave	Odds de consenso (média) entre todas as casas por mercado
parlayapi_find_middles	chave	Oportunidades de middle entre casas

Recursos

parlayapi://docs/quickstart - Exemplos de código em Python e JS.

Desenvolvimento local

git clone https://github.com/JacobiusMakes/parlay-api-mcp
cd parlay-api-mcp
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

Política de Privacidade

Esta extensão se conecta à ParlayAPI. Veja a Política de Privacidade da ParlayAPI.

Licença

MIT

---

Parte do ecossistema ParlayAPI: uma API de odds esportivas em tempo real com um nível gratuito de 1.000 créditos por mês, sem cartão de crédito. Explore todas as ferramentas em github.com/JacobiusMakes.