The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Apuração Eleições 2026 (TSE) listing page.
Resultados oficiais e parciais das eleições brasileiras, direto dos arquivos públicos da
divulgação do TSE (resultados.tse.jus.br), como tools MCP para Claude, Cursor, VS Code e
qualquer cliente Model Context Protocol — e, opcionalmente,
como bot inline do Telegram.
sp-c0003-e000xxx-r.json…), faz cache respeitoso (≥ 45 s por arquivo, If-Modified-Since) e
normaliza a resposta.apurado_pct e o horário do TSE. Nenhuma
projeção, nenhum comentário, nenhum anúncio.Claude Desktop (claude_desktop_config.json) / Cursor / VS Code (mcp.json):
Claude Code:
Também está no registro MCP oficial
como io.github.daniel-filius/apuracao-2026.
| Tool | O que devolve |
|---|---|
listar_eleicoes() | Eleições ordinárias no config oficial do TSE (ciclo, código, data, turno, cargos por abrangência) e histórico disponível |
resultado(uf, cargo, turno=1, ano=None, limite=20) | Parcial oficial por UF (SP, RJ…) ou BR (só presidente) |
resumo_brasil(turno=1, ano=None) | Presidente, total nacional |
municipio(uf, municipio, cargo, turno=1, ano=None) | Parcial oficial por município (nome exato, código IBGE ou código TSE) |
Cargos: presidente, governador, senador, deputado_federal, deputado_estadual,
deputado_distrital, prefeito, vereador.
Toda resposta inclui:
Exemplos de pergunta ao agente: "quem está na frente para governador do RS?", "como está a apuração para presidente?", "resultado de prefeito em Campinas em 2024".
Os códigos de 2026 só aparecem no config oficial (ele-c.json) perto da votação. Até lá, as
tools explicam isso e você pode usar dados históricos: ano=2022 (Eleições Gerais, 1º/2º turno)
e ano=2024 (municipais).
@Apuracao2026Bot em qualquer grupo: @Apuracao2026Bot SP governador ou @Apuracao2026Bot br.
Comandos: /start, /br, /uf SP [cargo].
O bot só sobe se existir APURACAO_BOT_TOKEN (ver .env.example); sem token ele sai
imediatamente. Long polling, stdlib apenas, métricas anônimas (ids hasheados) em metrics.jsonl.
Publicação: tag vX.Y.Z → workflow publish-mcp.yml roda os testes, publica a imagem em
ghcr.io/daniel-filius/apuracao-2026-mcp e registra no registro MCP oficial via GitHub OIDC
(server.json).
Projeto voluntário, sem fins políticos e sem anúncios. Se foi útil na noite da apuração, um Pix ajuda a manter em 2028:
Pix copia-e-cola (valor livre):
https://resultados.tse.jus.br/oficial/…). Este projeto não é
vinculado ao TSE. Números "parciais" podem mudar até a totalização final.Licença MIT.