senado_execucao_orcamentaria
ActiveTool of Senado BR MCP
Execução orçamentária do Senado: despesas (dotação, empenhado, liquidado, pago; desde 2013) ou receitas próprias (previstas e arrecadadas; desde 2012). Para maior/menor/média/mediana/distribuição/ranking ('quanto o Senado pagou/arrecadou com X', 'maior grupo de despesa') use `estatisticas=true`: 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`. Retorna `{ tipo, modo, ano, totalLinhas, ... }`: nos modos agregados, `agregado[]` com `{ chave, ...valores }` ordenado por valor; em `detalhe`, `despesas[]`/`receitas[]` limitado por `limite` (padrão 100, com `aviso` ao truncar). Use `tipo=despesas` com `modo` por-ano/por-acao/por-grupo/por-fonte e `tipo=receitas` com por-origem; filtre por `ano` para reduzir o volume antes de pedir `detalhe`. Única ferramenta de orçamento interno do Senado; não confundir com `senado_orcamento_parlamentar` (emendas/ofícios parlamentares ao orçamento da União).
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ano": {
"type": "integer",
"maximum": 2100,
"minimum": 2012,
"description": "Filtrar por exercício financeiro"
},
"modo": {
"enum": [
"por-ano",
"por-acao",
"por-grupo",
"por-fonte",
"por-origem",
"detalhe"
],
"type": "string",
"default": "por-ano",
"description": "Agregação (por-acao/por-grupo/por-fonte: despesas; por-origem: receitas) ou detalhe. Ignorado quando estatisticas=true"
},
"tipo": {
"enum": [
"despesas",
"receitas"
],
"type": "string",
"default": "despesas",
"description": "despesas = dotação e execução; receitas = receitas próprias"
},
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho do top/bottom nas estatísticas (padrão: 10)"
},
"campo": {
"enum": [
"pago",
"liquidado",
"empenhado",
"dotacaoInicial",
"dotacaoAtualizada",
"arrecadada",
"prevista"
],
"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."
},
"limite": {
"type": "integer",
"default": 100,
"maximum": 1000,
"minimum": 1,
"description": "Máximo de linhas (padrão: 100)"
},
"agruparPor": {
"enum": [
"ano",
"acao",
"grupo",
"fonte",
"modalidade",
"resultadoLei",
"plano",
"origem",
"categoria",
"especie",
"natureza"
],
"type": "string",
"description": "Opcional: agrupa e ranqueia os resultados por esta dimensão (as opções válidas dependem do tipo)."
},
"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"
}
}
}Parent server
Senado BR MCP
https://github.com/SidneyBissoli/senado-br-mcp-cloudflare
2/7 registries