# Eleições 2026: Dados Públicos do TSE — how to use (mcp.ai)

Boletins de urna, logs e divulgação oficial do TSE das eleições 2026 (1º e 2º turno), com hash e link de origem, para você consultar e conferir com o ChatGPT ou o Claude. Cobre o 1º e o 2º turno; sem turno indicado, o padrão é o 2º. Cada número vem com o arquivo do TSE, o link oficial e o SHA-256, sem opinião. Dado bruto do TSE organizado para consulta. Não constitui laudo nem análise oficial. Serviço independente, não é do TSE. Grátis.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_eleicoes?ms=1793007060000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `eleicoes_cobertura`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/eleicoes`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/eleicoes/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/eleicoes/cobertura` — Quanto do acervo existe: seções com boletim de urna (BU) e com log de urna por UF, sobre o total de seções do TSE, e a hora da última sincronização. Use antes de tirar conclusão de dado por seção ou p
  - body: { ano?: integer, turno?: number }
- `POST https://api.mcp.ai/api/eleicoes/como/ler` — Glossário curto e neutro: boletim de urna, log de urna, código de carga, por que algumas seções fecham depois das 17h, prorrogação, fuso, biometria agregada, versões do arquivo e SHA-256. Mostra també
  - body: { ano?: integer }
- `POST https://api.mcp.ai/api/eleicoes/comparar/turnos` — 1º e 2º turno lado a lado, só números: do Brasil, de uma UF ou de um município (totais oficiais) ou de uma seção (boletim de urna), com a subtração 2º − 1º em cada campo e a conferência de que as vari
  - body: { ano?: integer, uf: string, municipio?: string, zona?: string|number, secao?: string|number, cargo?: string }
- `POST https://api.mcp.ai/api/eleicoes/conferir/bu/impresso` — Devolve o boletim de urna oficial de uma seção, campo a campo, para comparar com um BU impresso. Localize pelo código de carga impresso no papel ou por UF + município + zona + seção. Não lê foto: a co
  - body: { ano?: integer, codigo_carga?: string, turno?: number, uf?: string, municipio?: string, zona?: string|number, secao?: string|number, itens?: object[] }
- `POST https://api.mcp.ai/api/eleicoes/consultar/secao` — Boletim de urna (BU) oficial de uma seção eleitoral nas eleições 2026: votos por candidato, brancos, nulos, aptos, comparecimento, abertura e encerramento (hora local e de Brasília), biometria em cont
  - body: { ano?: integer, turno?: number, uf?: string, municipio?: string, zona?: string|number, secao?: string|number, secoes?: object[] }
- `POST https://api.mcp.ai/api/eleicoes/timeline/divulgacao` — Linha do tempo da divulgação do 2º turno no Brasil ou numa UF: cada versão do arquivo de resultado publicada pelo TSE (ou uma linha por hora, com os votos ganhos na hora), com % de seções totalizadas,
  - body: { ano?: integer, uf?: string, cargo?: string, agrupar?: string, max_pontos?: integer, de?: string, ate?: string }
- `POST https://api.mcp.ai/api/eleicoes/totais` — Totais oficiais por candidato (votos, % dos válidos, brancos, nulos, comparecimento, abstenções, seções totalizadas) no Brasil, numa UF ou num município, da última versão coletada do arquivo de result
  - body: { ano?: integer, turno?: number, nivel?: string, codigo?: string, uf?: string, municipio?: string, cargo?: string }
- `POST https://api.mcp.ai/api/eleicoes/verificar/hash` — Diz se um SHA-256 é igual ao de um arquivo oficial do TSE no acervo e qual é o arquivo; ou, dado o nome do arquivo (ex.: o03221pr7691000660045-bu.dat, br-c0001-e006258-u.json), devolve o SHA-256 regis
  - body: { ano?: integer, sha256?: string, arquivo?: string, itens?: object[] }
- `POST https://api.mcp.ai/api/eleicoes/votos/por/horario` — Votos computados por faixa de horário (Brasília) no 2º turno, contados nos logs de urna, por UF, por município ou com uf 'BR' para todas as UFs lado a lado. Informa quantas seções têm log no acervo em
  - body: { ano?: integer, turno?: number, uf: string, municipio?: string, de?: string, ate?: string, intervalo_minutos?: number }

## Example prompts
- "Compare o 1º e o 2º turno para presidente no Brasil: a variação de cada candidato, de brancos, nulos e abstenção, e se as variações somam a variação do eleitorado. Para cada número, mostre o arquivo do TSE, o link oficial e o SHA-256."
- "Nos logs de urna do 2º turno, quantos votos foram computados entre 17h30 e 19h, por UF? Diga quantas seções com log existem no acervo em cada UF."
- "Tenho um boletim de urna impresso com o código de carga [CÓDIGO]. Ache a seção e mostre votos, aptos, brancos, nulos e o horário de encerramento do arquivo oficial, para eu comparar com o papel."
- "Mostre a linha do tempo da divulgação do 2º turno no Brasil, uma linha por hora: % de seções totalizadas e votos de cada candidato. Diga a partir de que horário o acervo tem dados."
- "Para a UF [SIGLA], compare 1º e 2º turno para presidente: votos e % válidos de cada candidato, abstenção, brancos e nulos, com a diferença de cada campo."
- "Para o município [NOME] em [UF], compare 1º e 2º turno para presidente com a subtração de cada campo, e confira se candidatos, brancos e nulos somam o comparecimento nos dois turnos."
- "Em [MUNICÍPIO]/[UF], escolha uma seção que encerrou depois das 17h30 e mostre o boletim de urna dela: abertura, encerramento, votos por candidato e o resumo do log. Compare com o 1º turno da mesma seção."
- "Qual foi o % de votos válidos de cada candidato em Santa Catarina no 1º e no 2º turno, e quanto mudou em pontos percentuais? Faça a mesma conta para o Brasil."
- "Quantos eleitores a mais compareceram no 2º turno em relação ao 1º no Brasil? Mostre ao lado a variação de votos de cada candidato."
- "Qual foi a abstenção no 1º e no 2º turno de 2026, em número e em %? Se o acervo não tiver eleições anteriores, diga isso e indique onde conferir no TSE."
- "Para [UF], mostre os votos computados por faixa de 30 minutos entre 16h e 19h30, pelos logs de urna, com a cobertura de log. Repita para [OUTRA UF] e coloque lado a lado."
- "Verifique o SHA-256 [HASH] contra os arquivos do TSE no acervo: a qual arquivo e a qual versão ele pertence, e como confiro o arquivo atual no site do TSE."

## More
- Page: https://mcp.ai/eleicoes
- Agent spec (llms.txt): https://mcp.ai/eleicoes/llms.txt
- Postman collection: https://mcp.ai/eleicoes/postman.json