Senado BR — Brazilian Federal Senate Open Data

Notas taquigráficas

senado_notas_taquigraficas

Read-onlyIdempotent

Fetch official transcripts (notas taquigráficas) of Brazilian Senate plenary sessions and committee meetings. Get sequential blocks as summary or full text, filter by speaker, and paginate through results.

Instructions

Transcrição oficial (notas taquigráficas) de uma sessão plenária ou reunião de comissão, em blocos sequenciais. Retorna { id, tipo, sessao, data, totalBlocos, aviso?, blocos }; id inexistente ou sem transcrição no acervo retorna totalBlocos 0 com aviso explicando. Cobertura: sessões plenárias do SF (deliberativas, não deliberativas, especiais) são transcritas em poucos dias; sessões CONJUNTAS do Congresso, canceladas/não realizadas e algumas solenes NÃO têm notas (a mídia pode existir em senado_videos_taquigrafia). modo governa o payload: resumo (padrão) traz por bloco sequencia, dataInicio/Fim, trecho (200 chars), caracteres e linkAudio, limitado a limite (padrão 20; pagine com sequenciaInicio, aviso sinaliza corte); texto traz o conteúdo integral de até 20 blocos por chamada (janela sequenciaInicio→sequenciaFim) e inclui intervalo. sequenciaFim só atua em modo=texto. Obtenha o id via senado_agenda_plenario/senado_resultado_plenario (sessão) ou senado_reuniao_comissao (reunião); orador filtra blocos pelo nome citado. Para a mídia (vídeo/áudio) use senado_videos_taquigrafia, não esta.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	Código da sessão plenária ou da reunião de comissão
`modo`	No	resumo = blocos com trecho inicial; texto = transcrição integral dos blocos selecionados	resumo
`tipo`	No	sessao = plenário (padrão); reuniao = comissão	sessao
`limite`	No	modo=resumo: máximo de blocos por chamada (padrão 20); o excedente é sinalizado em aviso
`orador`	No	Retorna só blocos cujo texto menciona este nome (busca parcial no conteúdo)
`sequenciaFim`	No	Último bloco no modo texto (ignorado no modo resumo); a janela é capada em 20 blocos por chamada
`sequenciaInicio`	No	Primeiro bloco a retornar (base 1); pagina o modo resumo e abre a janela do modo texto (padrão: 1)

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedv3.9.0Sep 24, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / additionalProperties
```
Added value: +false
```

addedInput schema / properties / limite

Added value: +{
+  "default": 20,
+  "description": "modo=resumo: máximo de blocos por chamada (padrão 20); o excedente é sinalizado em aviso",
+  "maximum": 100,
+  "minimum": 1,
+  "type": "integer"
+}

changedInput schema / properties / orador / description

Previous value: -"Filtra blocos que mencionam este nome (busca no texto)"New value: +"Retorna só blocos cujo texto menciona este nome (busca parcial no conteúdo)"

changedInput schema / properties / sequenciaFim / description

Previous value: -"Último bloco a retornar no modo texto (máx. 20 blocos por chamada)"New value: +"Último bloco no modo texto (ignorado no modo resumo); a janela é capada em 20 blocos por chamada"

changedInput schema / properties / sequenciaInicio / description

Previous value: -"Primeiro bloco (quarto) a retornar no modo texto (padrão: 1)"New value: +"Primeiro bloco a retornar (base 1); pagina o modo resumo e abre a janela do modo texto (padrão: 1)"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed5 schema fields changedv3.3.3Jul 6, 2026
- removedInput schema / additionalProperties
```
Removed value: -false
```
- addedInput schema / properties / id / maximum
```
Added value: +9007199254740991
```
- addedInput schema / properties / sequenciaFim / maximum
```
Added value: +9007199254740991
```
- addedInput schema / properties / sequenciaInicio / maximum
```
Added value: +9007199254740991
```
- changedOutput schema / additionalProperties
```
Previous value: -trueNew value: +{}
```
First observedv3.3.1Jun 25, 2026

TDQS

A4.8/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the readOnly/idempotent annotations: it discloses the empty-result contract (unknown id or no transcript returns totalBlocos 0 with an `aviso`), the coverage/timing characteristics of each session type, truncation behavior (`aviso` signals a cut, 20-block cap in texto mode) and the cross-parameter rule that `sequenciaFim` only acts in modo=texto.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dense but front-loaded: identity, return shape, coverage caveats, then mode/pagination semantics, then sourcing and the sibling hand-off. It is long for one paragraph, and some coverage detail (e.g. the several session-type enumerations) could be trimmed, but every sentence carries operative information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter tool with an output schema, annotations and a large sibling set, the description covers sourcing of the id, mode semantics, pagination, truncation signaling, empty results and the media alternative — nothing an agent needs to invoke it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the schema already documents each parameter, but the description adds meaning the schema does not: how `modo` reshapes the whole payload, that pagination in resumo mode runs through `sequenciaInicio`, and that `orador` matches partial names in the block text. These cross-parameter interactions are genuinely additive rather than restated.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource: the official transcription (notas taquigráficas) of a plenary session or committee meeting, returned in sequential blocks. It explicitly distinguishes itself from the closest sibling, senado_videos_taquigrafia, which covers media rather than text transcripts.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit prerequisites (obtain the `id` via senado_agenda_plenario/senado_resultado_plenario for sessions or senado_reuniao_comissao for meetings) and an explicit exclusion (for video/audio use senado_videos_taquigrafia, not this). It also states coverage limits — joint Congress sessions, cancelled/non-held sessions and some solemn sessions have no notes.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server