# Open data and access for AI agents

All Brazil Election 2026 results are public and free, no registration: in JSON, in Markdown, through an MCP server and an A2A agent, with data from the Tribunal Superior Eleitoral (TSE).

Source: Tribunal Superior Eleitoral (https://resultados.tse.jus.br) · https://eleicoes2026brasil.com/en/dados

## Results in JSON

The same files that feed the map, updated every few seconds during the count. Votes are indexed by the candidate's number on the ballot. Full description in OpenAPI 3.1: https://eleicoes2026brasil.com/openapi.json.

During the count, the /feed/ addresses may respond with a redirect (302) to the same live file: follow the redirect (with curl, use -L). The files are meant for servers, scripts and agents; pages on other sites cannot read them from the browser.

| Address | What it contains |
| --- | --- |
| https://eleicoes2026brasil.com/feed/agora.json | Current totals: president (Brazil, states and abroad), governor and Senate by state |
| https://eleicoes2026brasil.com/feed/municipios.json | Summary by municipality: leader, lead, polling stations counted and turnout |
| https://eleicoes2026brasil.com/feed/uf/sp.json | President in each municipality of a state (replace sp with the abbreviation; zz for abroad) |
| https://eleicoes2026brasil.com/feed/cidade/3550308-gov.json | Governor (-gov) or Senate (-sen) in one municipality, by IBGE code |
| https://eleicoes2026brasil.com/feed/zonas/3550308.json | President by electoral zone of a municipality |
| https://eleicoes2026brasil.com/feed/deputados/br.json | Chamber of Deputies: seats by party and most-voted (by state: /feed/deputados/sp.json) |
| https://eleicoes2026brasil.com/feed/historico.json | The count for president through the night |

## The presidential final count in CSV

The final count of both presidential rounds, read once the last section was counted, in CSV files for spreadsheets, R, Python and GIS: comma-separated, UTF-8, with one header row. They hold counts only (every share can be recomputed), and each municipality carries its IBGE code, to join with the Census and other data. In Excel, open them through Data › Get Data › From Text/CSV.

1st-round columns start with t1_, runoff columns with t2_ and the 2022 election's with r22_ (r22_t1_ and r22_t2_). In each round: secoes (sections), eleitorado (registered voters), comparecimento (turnout), abstencao (abstention), brancos (blank), nulos (null), votos_validos (valid votes) and one column of votes per candidate, with the ballot number and the name (t2_votos_13_lula). Abstention is the TSE's; turnout plus abstention is the base of the abstention rate.

Boa Esperança do Norte (MT), installed in 2025, has no 1st-round file of its own: its figures are its state's total minus the other municipalities (column t1_derivado = 1). The analyses made from these files are at https://eleicoes2026brasil.com/en/analise.

| Address | Each row is |
| --- | --- |
| https://eleicoes2026brasil.com/data/2026/presidente-municipios.csv | a municipality: 1st round, runoff and the 2022 election |
| https://eleicoes2026brasil.com/data/2026/presidente-estados.csv | a state or abroad: 1st round, runoff and 2022 |
| https://eleicoes2026brasil.com/data/2026/presidente-zonas.csv | an electoral zone of the municipalities with more than one: 1st round and runoff |
| https://eleicoes2026brasil.com/data/2026/presidente-exterior.csv | a city abroad: 1st round and runoff |
| https://eleicoes2026brasil.com/data/2026/presidente-apuracao.csv | the national totals the TSE published at a moment of the night, from 17:00 Brasília time, in both rounds |
| https://eleicoes2026brasil.com/data/2026/governador-2t-municipios.csv | a municipality of the six states with a governor runoff |

## Every page in Markdown

Every results page has a Markdown version, with the answer in one paragraph, the tables and the FAQ: add ".md" to the address (https://eleicoes2026brasil.com/governadores/sp.md), use the /md path (https://eleicoes2026brasil.com/md/governadores/sp) or request the same URL with the header Accept: text/markdown.

The site map for language models is at https://eleicoes2026brasil.com/llms.txt, and the text of all national and state pages at https://eleicoes2026brasil.com/llms-full.txt. Settled results and lead changes are also published as RSS (https://eleicoes2026brasil.com/atualizacoes.xml).

## MCP server

For Claude, ChatGPT, Cursor and other Model Context Protocol clients: https://eleicoes2026brasil.com/mcp (Streamable HTTP, no login and no session). In Claude Code: claude mcp add --transport http eleicoes2026 https://eleicoes2026brasil.com/mcp. The server description is at https://eleicoes2026brasil.com/.well-known/mcp/server-card.json.

| Tool | What it does |
| --- | --- |
| search_places | Buscar local ou candidato |
| get_results | Resultado da eleição |
| ask | Perguntar sobre a eleição |

## A2A agent

Agents that speak the Agent2Agent protocol can ask questions in Portuguese at the JSON-RPC endpoint https://eleicoes2026brasil.com/a2a (SendMessage method) and receive the answer in Markdown. The agent card is at https://eleicoes2026brasil.com/.well-known/agent-card.json.

## Discovery files

So that agents can find all of this on their own, the home page announces these files in the HTTP Link header:

| File | Standard |
| --- | --- |
| https://eleicoes2026brasil.com/.well-known/api-catalog | API catalog (RFC 9727) |
| https://eleicoes2026brasil.com/openapi.json | OpenAPI 3.1 |
| https://eleicoes2026brasil.com/.well-known/mcp/server-card.json | MCP Server Card |
| https://eleicoes2026brasil.com/.well-known/agent-card.json | A2A Agent Card |
| https://eleicoes2026brasil.com/.well-known/agent-skills/index.json | Agent Skills (the skill in https://eleicoes2026brasil.com/.well-known/agent-skills/eleicoes-2026-brasil/SKILL.md) |
| https://eleicoes2026brasil.com/.well-known/ai-catalog.json | AI Catalog (ARD) |
| https://eleicoes2026brasil.com/auth.md | Auth.md: anonymous access, no credentials |
| https://eleicoes2026brasil.com/robots.txt | Robot rules, with Content-Signal |
| https://eleicoes2026brasil.com/sitemap.xml | Sitemap of all pages |

## Use and citation

The numbers are those published by the Tribunal Superior Eleitoral; the methodology is at https://eleicoes2026brasil.com/sobre. When republishing, cite Brazil Election 2026 (https://eleicoes2026brasil.com) and the TSE. Search and AI bots may read, index and use the content (see robots.txt). Questions: contato@eleicoes2026brasil.com.

## Frequently asked questions

### Is the data free?

Yes. The JSON files, the Markdown pages, the MCP server and the A2A agent are public, free and require no registration or access key.

### How often is the data updated?

During the count, the totals are updated every few seconds, as soon as the TSE publishes new polling stations. Each file shows the time it was generated.

### How do I ask ChatGPT or Claude about the election using this data?

Add the MCP server https://eleicoes2026brasil.com/mcp to your client (in Claude, under Connectors; in Claude Code, with claude mcp add). Then just ask, for example: "who won the governor's race in Minas Gerais?".

### How do I find a municipality's IBGE code?

Each state's page lists all its municipalities with a link to each, and the address of a municipality's page ends in its IBGE code (for example, https://eleicoes2026brasil.com/presidente/sp/3550308 is São Paulo). The search_places tool of the MCP server also returns the code.

## Results

- [President](https://eleicoes2026brasil.com/en)
- [Governors](https://eleicoes2026brasil.com/en/governadores)
- [Senate](https://eleicoes2026brasil.com/en/senado)
- [Deputies](https://eleicoes2026brasil.com/en/deputados)
- [Election analysis](https://eleicoes2026brasil.com/en/analise)
- [About and methodology](https://eleicoes2026brasil.com/en/sobre)