senado_ceaps
ActiveTool of Senado BR MCP
Despesas da Cota para Exercício da Atividade Parlamentar (CEAPS) dos senadores em um ano. Para perguntas de **maior/menor/média/mediana/distribuição/ranking** ('quem gastou mais CEAPS', 'gasto mediano', 'distribuição das despesas') use `estatisticas=true`: computa min/máx/média/mediana/desvio/percentis sobre TODAS as despesas filtradas e devolve `top`/`bottom` (padrão 10) com identificadores — os modos agregados só somam por grupo e não revelam a distribuição nem o extremo individual. Sem `agruparPor` → `distribuicao` das despesas individuais + `top`/`bottom`; com `agruparPor` (`senador`/`tipo`/`mes`/`fornecedor`) → `grupos[]` ranqueados por soma decrescente (`grupos[0]` = maior gastador), cada um com sua mini-distribuição. Sem `estatisticas`: nos modos agregados (`por-senador`/`por-tipo`/`por-mes`/`por-fornecedor`, padrão `por-senador`) traz `agregado[]` ordenado por `total` desc com `chave`, `total` e `despesas` (contagem); em `modo='detalhe'` traz `despesas[]` (mês, data, senador, tipoDespesa, fornecedor, cnpjCpf, valor). Filtre por `mes`, `codSenador`, `nomeSenador`, `tipoDespesa` ou `fornecedor` (busca parcial); `limite` cap 100 com `aviso` ao truncar. Obtenha `codSenador` via `senado_listar_senadores`.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ano"
],
"properties": {
"ano": {
"type": "integer",
"maximum": 2100,
"minimum": 2008,
"description": "Ano das despesas"
},
"mes": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Filtrar por mês"
},
"modo": {
"enum": [
"por-senador",
"por-tipo",
"por-mes",
"por-fornecedor",
"detalhe"
],
"type": "string",
"default": "por-senador",
"description": "Agregação ou detalhe (padrão: por-senador). Ignorado quando estatisticas=true"
},
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)"
},
"limite": {
"type": "integer",
"default": 100,
"maximum": 1000,
"minimum": 1,
"description": "Máximo de linhas no resultado (padrão: 100)"
},
"agruparPor": {
"enum": [
"senador",
"tipo",
"mes",
"fornecedor"
],
"type": "string",
"description": "Quando estatisticas=true, ranqueia os grupos por soma decrescente (grupos[0] = maior gastador), cada grupo com sua mini-distribuição"
},
"codSenador": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filtrar por código do senador"
},
"fornecedor": {
"type": "string",
"description": "Filtrar por fornecedor (busca parcial)"
},
"nomeSenador": {
"type": "string",
"description": "Filtrar por nome do senador (busca parcial)"
},
"tipoDespesa": {
"type": "string",
"description": "Filtrar por tipo de despesa (busca parcial)"
},
"estatisticas": {
"type": "boolean",
"default": false,
"description": "Computa estatísticas (min/máx/média/mediana/percentis) + ranking top/bottom sobre todas as despesas filtradas. Use para 'quem gastou mais/menos', 'gasto médio/mediano', 'distribuição', 'ranking'"
}
}
}Parent server
Senado BR MCP
https://github.com/SidneyBissoli/senado-br-mcp-cloudflare
2/7 registries