Dados Abertos Senado BR MCP

Análise de consultas públicas

senado_ecidadania_consultas_analise

Read-onlyIdempotent

Analisa o conjunto completo de consultas públicas abertas (matérias em tramitação) do e-Cidadania por grau de concordância cidadã, conforme modo: consenso → consultas com alta concentração de votos numa direção, ordenadas da maior para a menor concentração; usa percentualMinimo (padrão 85%). polarizada → consultas com votação equilibrada (~50/50), ordenadas da menor para a maior diferença sim/não; usa margemPolarizacao (padrão 15 pontos). Analisa por padrão consultas aberta (opinião pública atual). Quando a matéria sai de tramitação a consulta passa a encerrada, então status: "encerrada"/"todas" cobrem o conjunto que foi encerrado desde a ingestão (cresce com o tempo); fechadas antes da 1ª carga não são capturadas. Todos os modos aceitam minimoVotos (padrão 1000) e limite (padrão 10). Retorna { modo, criterio, count, consultas }. É esta a ferramenta para 'consultas mais votadas', ranking ou panorama ATUAL da votação das consultas em tramitação — não confundir com senado_ecidadania_consultas_votos, que é o acervo HISTÓRICO (matérias já arquivadas) com quebra por UF. Para o detalhe de uma consulta use senado_ecidadania_obter_consulta.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`modo`	No	consenso (alta concordância) ou polarizada (~50/50)	consenso
`limite`	No	Número máximo de resultados
`status`	No	Recorte do conjunto (padrão: aberta = opinião atual). encerrada cobre consultas que saíram de tramitação desde a ingestão (cresce com o tempo); fechadas antes da 1ª carga não são capturadas.	aberta
`minimoVotos`	No	Mínimo de votos para considerar
`percentualMinimo`	No	Modo consenso: percentual mínimo numa direção
`margemPolarizacao`	No	Modo polarizada: considera polarizado se diferença ≤ este percentual

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 11, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```

Changed2 schema fields changedAug 31, 2026

changedInput schema / $schema

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

changedOutput schema / $schema

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

Changed3 schema fields changedJun 28, 2026
- removedInput schema / additionalProperties
```
Removed value: -false
```
- addedInput schema / properties / minimoVotos / maximum
```
Added value: +9007199254740991
```
- changedOutput schema / additionalProperties
```
Previous value: -trueNew value: +{}
```

Changed1 schema field changedJun 22, 2026

changedInput schema / properties / status / description

Previous value: -"Recorte do conjunto (padrão: aberta = opinião atual)"New value: +"Recorte do conjunto (padrão: aberta = opinião atual). encerrada cobre consultas que saíram de tramitação desde a ingestão (cresce com o tempo); fechadas antes da 1ª carga não são capturadas."

Changed1 schema field changedJun 17, 2026

addedInput schema / properties / status

Added value: +{
+  "default": "aberta",
+  "description": "Recorte do conjunto (padrão: aberta = opinião atual)",
+  "enum": [
+    "aberta",
+    "encerrada",
+    "todas"
+  ],
+  "type": "string"
+}

AddedJun 14, 2026

TDQS

A4.5/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, destructiveHint=false, covering safety. The description adds critical data-availability context: 'encerrada' only covers consultations closed since ingestion (grows over time), and those closed before the first load are not captured. This is valuable beyond annotations, though no rate limits or cache behavior are mentioned.

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?

The description is dense but front-loaded, covering modes, defaults, status semantics, return shape, and sibling routing in a single paragraph. It is slightly long but every sentence adds value; no filler.

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

Completeness4/5

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

Given 6 parameters, output schema, and full schema coverage, the description covers the tool's purpose, modes, status behavior, defaults, and return fields (modo, criterio, count, consultas). It lacks edge cases like pagination for limite>50 or error handling, but is otherwise complete.

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 description coverage is 100%, so the schema already documents each parameter. The description adds quantitative defaults (percentualMinimo 85%, margemPolarizacao 15 points, minimoVotos 1000, limite 10) and clarifies the sorting logic for each mode, going beyond the schema. It does not explain the parameters' interaction fully, so not a 5.

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?

The description states a specific verb (analisa) and a precise resource (conjunto completo de consultas públicas abertas) and explains the two analysis modes. It explicitly differentiates from siblings senado_ecidadania_consultas_votos (historical archive with UF breakdown) and senado_ecidadania_obter_consulta (single consultation detail).

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 conditions for each mode (consenso=high agreement, polarizada=~50/50) and names the alternative tools for other tasks. The final sentence directly instructs when to use this tool for 'most voted consultations, ranking, or current panorama'.

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

All Dados Abertos Senado BR MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.