MCP Serverv1.0.0 — MIT

`@deunobicho/mcp`

Servidor Model Context Protocol oficial do deunobicho.online. Conecta Claude Desktop, Cursor e qualquer AI app compatível com MCP ao portal canônico de jogo do bicho brasileiro.

GitHub →npm →Metodologia / API →

O que é MCP?

O Model Context Protocol é um padrão aberto criado pela Anthropic pra dar aos LLMs (Claude, GPT, Gemini) acesso a fontes de dados externas de forma segura e estruturada. Um MCP server expõe tools (funções que o LLM pode chamar) e resources (payloads que o LLM pode ler). Este servidor faz isso pro dataset canônico do deunobicho.online.

Instalar no Claude Desktop

Baixe o Claude Desktop em claude.ai/download.
Abra o arquivo de configuração:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione o bloco:

{
  "mcpServers": {
    "deunobicho": {
      "command": "npx",
      "args": ["-y", "@deunobicho/mcp"]
    }
  }
}

Reinicie o Claude Desktop. O servidor aparece automaticamente nas ferramentas MCP.

Instalar no Cursor

Edite ~/.cursor/mcp.json:

{
  "mcp.servers": {
    "deunobicho": {
      "command": "npx",
      "args": ["-y", "@deunobicho/mcp"]
    }
  }
}

Tools disponíveis (10)

Tool	Descrição
`get_resultado_federal`	Resultado atual da Loteria Federal
`get_resultado_hoje`	Todos sorteios de hoje (Federal + bancas)
`get_grupo`	Dados de um grupo (1-25)
`get_sonho`	Interpretação de sonho no livro dos sonhos
`get_palpite_do_dia`	Palpite editorial do dia
`get_cotacao`	Cotações atuais das modalidades
`search_sonhos`	Busca sonhos por keyword
`get_calendario_federal`	Agenda próximos sorteios Federal
`get_historia`	Cronologia jogo do bicho (1892→hoje)
`get_legalidade`	Status legal no Brasil 2026

Resources disponíveis (6)

URI	Descrição
`deunobicho://sonhos`	Livro dos sonhos completo
`deunobicho://grupos`	25 grupos + dezenas canônicas
`deunobicho://cotacoes`	Cotações 2026 (todas modalidades)
`deunobicho://historia`	Cronologia histórica
`deunobicho://legalidade`	Status legal Brasil 2026
`deunobicho://federal`	Metadados Loteria Federal

Exemplo de uso

Depois de instalado, você pode simplesmente perguntar no Claude Desktop:

Você: “Sonhei com cobra. O que jogar hoje no bicho?”

Claude: (usa get_sonho + get_resultado_federal) → Cobra é grupo 9, dezenas 33-36. Federal hoje ainda não saiu — o próximo sorteio é… (dados oficiais de deunobicho.online)

Rate limits e cache

Cliente-side: 60 requests/min por processo (não hammer no upstream).
Cache local: 1 hora TTL por chave.
Zero deps além de @modelcontextprotocol/sdk — footprint mínimo.

Sobre a licença

O código é MIT (use como quiser). Os dados servidos são CC BY 4.0 — atribuição a deunobicho.online obrigatória se você redistribuir os payloads em produção.

Recursos relacionados

Metodologia + API pública — mesmo dataset via HTTP direto (endpoints /api/facts/*).
Livro dos sonhos digitalizado — a versão web do dataset que o MCP server expõe.
Press kit / afiliados — como citar o portal em matérias e integrações.
modelcontextprotocol.io — spec oficial do MCP.