senado_suprimento_fundos
ActiveTool of Senado BR MCP
Suprimento de fundos do Senado (adiantamentos a supridos): relação anual de supridos, atos de concessão, empenhos, movimentações ou transações de cartão corporativo, conforme `tipo`. Retorna `{ ano, tipo, count, total, registros }` (snake_case da API administrativa), filtrável por `filtro` textual e limitado por `limite` (padrão 100, máx 500); ao truncar, inclui `aviso`. Para maior/menor/média/mediana/distribuição/ranking ('quem mais recebeu', 'fornecedor com maior gasto', 'valor mediano') use `estatisticas=true` (só nos tipos `transacoes`, `empenhos`, `atos-concessao` — os demais não têm coluna de valor): SEM `agruparPor` = distribuição das linhas (min/máx/média/mediana/percentis) + top/bottom; COM `agruparPor` = grupos ranqueados por soma decrescente (grupos[0]=maior). A coluna de valor analisada é escolhida automaticamente conforme o `tipo`; o resultado já traz o rótulo legível dela em `campoAnalisado`. Registros sem valor são excluídos das estatísticas. Em atos de concessão, cada beneficiário é identificado pelo NOME (cruzado com o cadastro de supridos) e pode-se usar `agruparPor='suprido'` para ranquear por beneficiário. Informe o `ano` (>=2010); use os mesmos códigos administrativos vistos em `senado_contratacoes_lista` ou `senado_execucao_orcamentaria` para cruzar gastos.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ano"
],
"properties": {
"ano": {
"type": "integer",
"maximum": 2100,
"minimum": 2010,
"description": "Ano de referência"
},
"tipo": {
"enum": [
"supridos",
"atos-concessao",
"empenhos",
"movimentacoes",
"transacoes"
],
"type": "string",
"default": "supridos",
"description": "Qual relação consultar (padrão: supridos)"
},
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho do top/bottom nas estatísticas (padrão: 10)"
},
"campo": {
"enum": [
"valor",
"valorExecutado",
"valorConcedido",
"valorTotalTransacoes",
"valorTotalEmpenhos",
"valorTotalElementosDespesa",
"valorTotalMovimentacoes"
],
"type": "string",
"description": "Opcional: força a coluna de valor analisada; por padrão ela é escolhida conforme o tipo. Se a opção não se aplicar ao tipo, o padrão é usado automaticamente."
},
"filtro": {
"type": "string",
"description": "Filtro textual (nome, unidade...)"
},
"limite": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1,
"description": "Máximo de resultados (padrão: 100)"
},
"agruparPor": {
"enum": [
"fornecedor",
"tipo",
"tipoInscricao",
"rubricas",
"rubrica",
"descricao",
"elementoDespesa",
"regimeEspecial",
"suprido"
],
"type": "string",
"description": "Opcional: agrupa e ranqueia os resultados por esta dimensão (as opções válidas dependem do tipo; em atos de concessão, `suprido` agrupa por beneficiário, com o nome)."
},
"estatisticas": {
"type": "boolean",
"default": false,
"description": "Distribuição/ranking sobre as linhas: min/máx/média/mediana/percentis + top/bottom, ou grupos ranqueados por soma via agruparPor. Só para tipo transacoes/empenhos/atos-concessao"
}
}
}Parent server
Senado BR MCP
https://github.com/SidneyBissoli/senado-br-mcp-cloudflare
2/7 registries