Apuração Eleições 2026 (TSE) MCP server

Apuração Eleições 2026 (TSE) — servidor MCP + bot Telegram

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.

• 1º turno: domingo 04/10/2026 · 2º turno: 25/10/2026
• Sem chave, sem cadastro: o TSE publica os JSON abertamente. Este projeto só decifra os códigos

projeção, nenhum comentário, nenhum anúncio.

• Neutralidade: só números oficiais, sempre com apurado_pct e o horário do TSE. Nenhuma

curado e auto-verificado de servidores MCP e skills brasileiros (categoria Eleições / Governo).

• Listado em awesome-mcp-brasil — hub

<!-- mcp-name: io.github.daniel-filius/apuracao-2026 -->

Instalar

Docker (imagem publicada em ghcr.io)

docker run -i --rm ghcr.io/daniel-filius/apuracao-2026-mcp:v0.1.0

Claude Desktop (claudedesktopconfig.json) / Cursor / VS Code (mcp.json):

{
  "mcpServers": {
    "apuracao-2026": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/daniel-filius/apuracao-2026-mcp:v0.1.0"]
    }
  }
}

Sem Docker (Python 3.11+ e uv)

uvx --from git+https://github.com/daniel-filius/apuracao-2026-mcp apuracao-mcp

{
  "mcpServers": {
    "apuracao-2026": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/daniel-filius/apuracao-2026-mcp", "apuracao-mcp"]
    }
  }
}

Claude Code:

claude mcp add apuracao-2026 -- uvx --from git+https://github.com/daniel-filius/apuracao-2026-mcp apuracao-mcp
# ou
claude mcp add apuracao-2026 -- docker run -i --rm ghcr.io/daniel-filius/apuracao-2026-mcp:v0.1.0

Também está no registro MCP oficial como io.github.daniel-filius/apuracao-2026.

Tools

Cargos: presidente, governador, senador, deputadofederal, deputadoestadual, deputado_distrital, prefeito, vereador.

Toda resposta inclui:

{
  "fonte": "TSE – divulgação oficial, resultado parcial",
  "atualizado_em": "04/10/2026 19:32:11",
  "apurado_pct": 87.31,
  "matematicamente_definido": false,
  "eleicao": {"ano": 2026, "turno": 1, "codigo": "…", "ciclo": "ele2026"},
  "cargo": "Governador", "abrangencia": "SP",
  "totais": {"votos_validos": 0, "brancos": 0, "nulos": 0, "abstencao_pct": 0.0, "…": "…"},
  "candidatos": [
    {"posicao": 1, "nome": "…", "numero": "10", "partido": "…", "votos": 0, "pct": 0.0, "situacao": "…", "eleito": false}
  ]
}

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".

Antes de o TSE publicar o pleito de 2026

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).

Shortened. The full README is on GitHub.