Skip to main content
Glama
MCP Câmara BR

MCP Câmara BR

by gvc2000

🏛️ MCP Câmara BR

Servidor MCP (Model Context Protocol) completo para a API de Dados Abertos da Câmara dos Deputados do Brasil.

Visão Geral

O mcp-camara-br é um servidor MCP que expõe todas as funcionalidades da API de Dados Abertos da Câmara dos Deputados através de tools tipadas, validadas e otimizadas para uso com Large Language Models (LLMs).

Características

  • ✅ Cobertura Completa - Mapeia os principais endpoints da API da Câmara

  • ✅ Validação Rigorosa - Inputs validados com Zod

  • ✅ Cache Inteligente - Sistema de cache em camadas com TTL diferenciado

  • ✅ Rate Limiting - Proteção contra sobrecarga da API

  • ✅ Circuit Breaker - Resiliência a falhas

  • ✅ Métricas - Observabilidade completa (Prometheus-ready)

  • ✅ Type-Safe - 100% TypeScript

  • ✅ Docker Ready - Containerizado e pronto para deploy

🚀 Início Rápido (5 minutos)

1. Instalar dependências

npm install

2. Compilar

npm run build

3. Configurar no Claude Desktop

Edite o arquivo de configuração:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Adicione a configuração:

macOS/Linux:

{
  "mcpServers": {
    "camara-br": {
      "command": "node",
      "args": ["/caminho/completo/para/AgenteCidadaoMCP/dist/server.js"]
    }
  }
}

Windows (use barras duplas \\):

{
  "mcpServers": {
    "camara-br": {
      "command": "node",
      "args": ["C:\\Users\\SeuUsuario\\AgenteCidadaoMCP\\dist\\server.js"]
    }
  }
}

⚠️ Importante para Windows: Use barras duplas (\\) nos caminhos. Veja o Guia Windows para mais detalhes.

4. Reiniciar Claude Desktop

Feche e abra o Claude Desktop novamente.

Requisitos

  • Node.js >= 20.0.0

  • npm ou yarn

📖 Guias de Instalação Detalhados

Escolha o guia apropriado para seu sistema operacional:

Instalação Completa

# Clonar o repositório
git clone https://github.com/gvc2000/AgenteCidadaoMCP.git
cd AgenteCidadaoMCP

# Instalar dependências
npm install

# Copiar arquivo de configuração
cp .env.example .env

# Build
npm run build

# Executar
npm start

Uso com Docker

# Build da imagem
docker-compose build

# Executar
docker-compose up -d

# Ver logs
docker-compose logs -f

# Parar
docker-compose down

Uso via HTTP (API REST)

O servidor também pode ser executado em modo HTTP, expondo uma API REST:

# Executar servidor HTTP
npm run start:http

# Ou em desenvolvimento com hot-reload
npm run dev:http

Endpoints HTTP

  • GET / - Informações da API

  • GET /api/tools - Lista todas as ferramentas disponíveis

  • POST /api/tools/:toolName - Executa uma ferramenta

  • GET /health - Health check

  • GET /metrics - Métricas Prometheus

  • GET /metrics/json - Métricas em JSON

Exemplo de Uso HTTP

# Buscar deputados
curl -X POST http://localhost:9090/api/tools/buscar_deputados \
  -H "Content-Type: application/json" \
  -d '{"uf":"SP","pagina":1,"itens":10}'

Configuração

Edite o arquivo .env para personalizar as configurações:

# API Configuration
API_BASE_URL=https://dadosabertos.camara.leg.br/api/v2

# Cache
CACHE_ENABLED=true
CACHE_TTL_SECONDS=600

# Rate Limiting
RATE_LIMIT_ENABLED=true
RATE_LIMIT_PER_MINUTE=100

# Metrics
METRICS_ENABLED=true
METRICS_PORT=9090

🛠️ Tools Disponíveis (57 tools)

Tools de Ajuda

  • sugerir_ferramentas - Sugere quais tools usar para uma consulta

  • diagnosticar_consulta - Analisa objetivo e sugere fluxo completo de tools

Deputados (9)

  • buscar_deputados - Busca deputados por nome, UF, partido, etc.

  • detalhar_deputado - Informações detalhadas de um deputado

  • despesas_deputado - Despesas da cota parlamentar

  • discursos_deputado - Discursos proferidos

  • eventos_deputado - Eventos que participou

  • frentes_deputado - Frentes parlamentares das quais é membro

  • ocupacoes_deputado - Histórico de ocupações na Câmara

  • orgaos_deputado - Órgãos dos quais é membro

  • profissoes_deputado - Profissões declaradas

Proposições (7)

  • buscar_proposicoes - Busca proposições legislativas (PLs, PECs, MPs, etc.)

  • detalhar_proposicao - Informações detalhadas de uma proposição

  • autores_proposicao - Lista os autores de uma proposição

  • tramitacoes_proposicao - Histórico de tramitação

  • votacoes_proposicao - Votações da proposição

  • relacionadas_proposicao - Proposições relacionadas

  • temas_proposicao - Temas/assuntos da proposição

Votações (5)

  • buscar_votacoes - Busca votações por período ou proposição

  • detalhar_votacao - Resultado geral de uma votação

  • votos_votacao - Voto individual de cada deputado

  • orientacoes_votacao - Orientação dos partidos

  • ultimas_votacoes - Votações mais recentes

Eventos (6)

  • buscar_eventos - Busca reuniões e sessões por período

  • detalhar_evento - Informações de um evento

  • deputados_evento - Deputados presentes

  • pauta_evento - Pauta do evento

  • votacoes_evento - Votações realizadas

  • orgaos_evento - Órgãos participantes

Órgãos (5)

  • buscar_orgaos - Busca comissões e órgãos

  • detalhar_orgao - Informações de um órgão

  • membros_orgao - Composição atual

  • eventos_orgao - Eventos do órgão

  • votacoes_orgao - Votações do órgão

Partidos (4)

  • buscar_partidos - Lista partidos

  • detalhar_partido - Informações de um partido

  • membros_partido - Deputados do partido

  • lideres_partido - Liderança do partido

Frentes Parlamentares (3)

  • buscar_frentes - Busca frentes parlamentares

  • detalhar_frente - Informações de uma frente

  • membros_frente - Membros da frente

Blocos (2)

  • buscar_blocos - Busca blocos partidários

  • detalhar_bloco - Informações de um bloco

Legislaturas (3)

  • buscar_legislaturas - Lista legislaturas

  • detalhar_legislatura - Informações de uma legislatura

  • mesa_legislatura - Mesa Diretora

Referências (5)

  • situacoes_proposicao - Situações possíveis de proposições

  • tipos_proposicao - Tipos de proposições (PL, PEC, etc.)

  • tipos_orgao - Tipos de órgãos da Câmara

  • tipos_evento - Tipos de eventos

  • ufs - Unidades Federativas

Análises (6)

  • analise_presenca - Taxa de presença de deputados

  • ranking_proposicoes - Ranking de proposições

  • analise_despesas_partido - Despesas agregadas por partido

  • comparativo_votacoes - Compara votações

  • timeline_tramitacao - Timeline de tramitação

  • exportar_dados - Exporta dados para CSV/JSON

💬 Exemplos de Uso

Buscar Deputados de SP do PT

Liste deputados do estado de São Paulo no partido PT

Ou via JSON:

{
  "tool": "buscar_deputados",
  "arguments": {
    "uf": "SP",
    "partido": "PT",
    "pagina": 1,
    "itens": 10
  }
}

Buscar Proposições sobre Educação

Busque projetos de lei sobre educação apresentados em 2024

Ou via JSON:

{
  "tool": "buscar_proposicoes",
  "arguments": {
    "keywords": "educação",
    "ano": 2024,
    "pagina": 1,
    "itens": 20
  }
}

Frentes Parlamentares de um Deputado

Quais frentes parlamentares o deputado Guilherme Boulos participa?

Análise Completa de um Deputado

Me conte sobre a deputada Tabata Amaral:
- Suas frentes parlamentares
- Despesas de janeiro de 2024
- Discursos recentes sobre educação

Despesas de um Deputado

Mostre as despesas do deputado Guilherme Boulos em janeiro de 2024

Ou via JSON (usando ID):

{
  "tool": "despesas_deputado",
  "arguments": {
    "id": 220000,
    "ano": 2024,
    "mes": 1
  }
}

Monitoramento

Métricas

O servidor expõe métricas no formato Prometheus:

# Métricas Prometheus
curl http://localhost:9090/metrics

# Métricas JSON
curl http://localhost:9090/metrics/json

# Health check
curl http://localhost:9090/health

Logs

Os logs são estruturados em JSON (padrão) ou formato pretty para desenvolvimento:

# Ativar logs pretty
LOG_FORMAT=pretty npm start

📁 Estrutura do Projeto

AgenteCidadaoMCP/
├── src/                          # Código-fonte do MCP Server
│   ├── server.ts                 # Entry point
│   ├── mcp.ts                    # MCP server setup
│   ├── config.ts                 # Configurações
│   │
│   ├── api/                      # Cliente HTTP e comunicação
│   │   ├── client.ts             # Cliente HTTP com retry
│   │   └── normalizers.ts        # Normalização de dados
│   │
│   ├── core/                     # Sistemas core
│   │   ├── cache.ts              # Sistema de cache LRU
│   │   ├── errors.ts             # Classes de erro customizadas
│   │   ├── logging.ts            # Logs estruturados (Pino)
│   │   ├── metrics.ts            # Métricas Prometheus
│   │   ├── rate-limiter.ts       # Rate limiting (token bucket)
│   │   ├── circuit-breaker.ts    # Circuit breaker pattern
│   │   ├── queue.ts              # Fila de requisições
│   │   └── schemas.ts            # Schemas Zod compartilhados
│   │
│   ├── tools/                    # MCP Tools organizados por categoria
│   │   ├── deputados/            # 10 tools sobre deputados
│   │   ├── proposicoes/          # 8 tools sobre proposições
│   │   ├── votacoes/             # 5 tools sobre votações
│   │   ├── orgaos/               # 6 tools sobre órgãos
│   │   ├── eventos/              # 7 tools sobre eventos
│   │   ├── partidos/             # 5 tools sobre partidos
│   │   ├── legislaturas/         # 4 tools sobre legislaturas
│   │   ├── frentes/              # 4 tools sobre frentes
│   │   ├── blocos/               # 3 tools sobre blocos
│   │   ├── referencias/          # 6 tools de referência
│   │   └── analises/             # 7 tools de análise e export
│   │
│   └── utils/                    # Utilitários
│       ├── aggregators.ts        # Agregação de dados
│       ├── currency.ts           # Formatação de moeda
│       ├── date.ts               # Utilitários de data
│       └── sanitizers.ts         # Sanitização de inputs
│
├── frontend/                     # Interface Web
│   ├── current/                  # Versão atual (v4)
│   │   ├── index.html           # Interface principal
│   │   ├── admin-agente-cidadao.html
│   │   ├── demo-agente-cidadao.html
│   │   └── login-agente-cidadao.html
│   ├── archive/                  # Versões anteriores
│   └── README.md                 # Documentação do frontend
│
├── docs/                         # Documentação organizada
│   ├── guides/                   # Guias de instalação e uso
│   │   ├── GUIA_INSTALACAO_USO.md
│   │   └── INICIO_RAPIDO.md
│   ├── examples/                 # Exemplos práticos
│   │   ├── EXEMPLOS_PRATICOS.md
│   │   └── EXEMPLOS_TESTES.md
│   ├── testing/                  # Planos e relatórios de testes
│   ├── process/                  # Artefatos de processo
│   ├── specs/                    # Especificações técnicas
│   │   └── mcp-camara-br-especificacao-completa.md
│   └── README.md                 # Índice da documentação
│
├── scripts/                      # Scripts utilitários
│   └── healthcheck.sh           # Health check para deploy
│
├── .github/                      # GitHub Actions
│   └── workflows/
│       ├── ci.yml               # CI/CD pipeline
│       └── release.yml          # Release automation
│
├── dist/                         # Código compilado (gerado)
│
├── .env.example                  # Template de variáveis de ambiente
├── .dockerignore                 # Arquivos ignorados no Docker build
├── .npmignore                    # Arquivos ignorados no npm publish
├── Dockerfile                    # Multi-stage Docker build
├── docker-compose.yml            # Docker Compose config
├── package.json                  # Configuração npm
├── tsconfig.json                 # Configuração TypeScript
│
├── README.md                     # Este arquivo
├── CONTRIBUTING.md               # Guia de contribuição
├── CLAUDE.md                     # Guia para assistentes de IA
└── LICENSE                       # Licença MIT

Desenvolvimento

# Modo desenvolvimento com watch
npm run dev

# Testes
npm test

# Cobertura de testes
npm run test:coverage

# Linting
npm run lint

# Formatação
npm run format

# Type checking
npm run type-check

⚡ Performance

O servidor implementa várias otimizações:

  • Cache em Camadas: Diferentes TTLs por tipo de dado

  • Rate Limiting: Token bucket algorithm

  • Circuit Breaker: Previne cascata de falhas

  • Request Queue: Controla concorrência

  • Retry Logic: Exponential backoff com jitter

🔄 CI/CD

O projeto possui workflows automatizados do GitHub Actions:

CI (Integração Contínua)

  • ✅ Type checking (TypeScript)

  • ✅ Linting (ESLint)

  • ✅ Formatação (Prettier)

  • ✅ Testes automatizados

  • ✅ Build em Node.js 20.x e 21.x

  • ✅ Build Docker

Release (Publicação)

  • 🚀 Criação automática de releases no GitHub

  • 🚀 Build de imagens Docker em tags

  • 📦 Preparado para publicação no npm (requer configuração)

Configuração: Os workflows estão em .github/workflows/:

  • ci.yml - Executado em push/PR para main/develop

  • release.yml - Executado ao criar tags (v*)

📚 Documentação Completa

Guias

Exemplos e Testes

Especificações

Integrações

Para Desenvolvedores

Índice Completo

🤝 Contribuindo

Contribuições são muito bem-vindas! Este projeto segue boas práticas de desenvolvimento e possui diretrizes claras para contribuidores.

Antes de contribuir, leia:

  • CONTRIBUTING.md - Guia completo de contribuição com padrões de código, workflow e boas práticas

Resumo rápido:

  1. Fork o projeto

  2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)

  3. Siga os padrões de código (TypeScript strict, ESLint, Prettier)

  4. Escreva testes para novas funcionalidades

  5. Commit usando Conventional Commits (feat:, fix:, etc.)

  6. Push para a branch (git push origin feature/MinhaFeature)

  7. Abra um Pull Request com descrição detalhada

Scripts úteis para desenvolvimento:

npm run validate    # Executa type-check + lint + format-check + tests
npm run lint:fix    # Corrige problemas de lint automaticamente
npm run format      # Formata o código com Prettier

Licença

MIT License - veja o arquivo LICENSE para detalhes.

Suporte

Para reportar bugs ou solicitar features, abra uma issue.


Desenvolvido com ❤️ para democratização de dados públicos

Available Tools

63 tools
analise_despesas_partidoB

Analisa e agrega despesas dos deputados de um partido em um período, com totais, médias ou por categoria

Inputs: siglaPartido (required), ano (required), mes, tipoAgregacao.

analise_presenca_deputadoC

Analisa a presença e participação de um deputado em eventos (reuniões, sessões, audiências) em um período específico

Inputs: idDeputado (required), dataInicio, dataFim.

autores_proposicaoC

Lista os autores de uma proposição legislativa

Inputs: id (required).

buscar_blocosC

Busca blocos parlamentares da Câmara dos Deputados

Inputs: idLegislatura, pagina, itens.

buscar_deputadosB

Busca deputados por diversos critérios. DICA: Use "nome" para busca por nome, ou combine "uf" + "partido" para filtrar por região e partido.

Inputs: nome, uf, partido, sexo, +7 more.

buscar_eventosB

Busca eventos da Câmara dos Deputados (reuniões, sessões, audiências). DICA: Use dataInicio + dataFim para buscar eventos em um período específico.

Inputs: idTipoEvento, idSituacao, idOrgao, dataInicio, +7 more.

buscar_frentesC

Busca frentes parlamentares da Câmara dos Deputados

Inputs: idLegislatura, pagina, itens.

buscar_legislaturasC

Busca legislaturas da Câmara dos Deputados

Inputs: data, pagina, itens, ordem, +1 more.

buscar_orgaosA

Busca órgãos da Câmara (comissões, mesas, conselhos, etc). Aceita busca por sigla (ex: CE para Comissão de Educação) ou por nome/apelido (busca parcial, ex: "educação" encontra "Comissão de Educação")

Inputs: sigla, nome, idTipoOrgao, dataInicio, +5 more.

buscar_partidosC

Busca partidos políticos representados na Câmara dos Deputados

Inputs: sigla, dataInicio, dataFim, idLegislatura, +4 more.

buscar_proposicoesA

Busca proposições legislativas (PLs, PECs, MPs, etc.) por diversos critérios. DICA: Comece com poucos parâmetros (ex: siglaTipo + ano, ou apenas keywords) e adicione filtros gradualmente.

Inputs: siglaTipo, numero, ano, idDeputadoAutor, +15 more.

buscar_votacoesA

Busca votações realizadas na Câmara dos Deputados. DICA: Comece com dataInicio + dataFim para buscar votações em um período, ou use idProposicao para votações de uma proposição específica.

Inputs: idProposicao, idEvento, idOrgao, dataInicio, +5 more.

comparativo_votacoes_bancadasA

Compara como diferentes bancadas partidárias votaram em uma votação específica, incluindo disciplina partidária

Inputs: idVotacao (required), incluirOrientacoes, incluirAusentes.

deputados_eventoB

Lista os deputados presentes ou relacionados a um evento

Inputs: id (required).

despesas_deputadoA

Lista as despesas de um deputado da cota parlamentar. Use buscar_deputados primeiro para obter o ID do deputado.

IMPORTANTE para agentes: Se você precisa de uma visão geral, use 'resumo_despesas_deputado' ao invés desta ferramenta. Esta tool retorna documentos fiscais completos e pode gerar muito texto. Use formato='resumido' ou limite itens para evitar overflow.

Inputs: id (required), ano, mes, tipoDespesa, +6 more.

detalhar_blocoB

Obtém detalhes de um bloco parlamentar específico

Inputs: id (required).

detalhar_deputadoC

Obtém informações detalhadas de um deputado específico

Inputs: id (required).

detalhar_eventoC

Obtém detalhes de um evento específico da Câmara

Inputs: id (required).

detalhar_frenteB

Obtém detalhes de uma frente parlamentar específica

Inputs: id (required).

detalhar_legislaturaC

Obtém detalhes de uma legislatura específica

Inputs: id (required).

detalhar_orgaoB

Obtém detalhes de um órgão específico da Câmara

Inputs: id (required).

detalhar_partidoC

Obtém detalhes de um partido político específico

Inputs: id (required).

detalhar_proposicaoC

Obtém informações detalhadas de uma proposição legislativa

Inputs: id (required).

detalhar_votacaoC

Obtém detalhes de uma votação específica

Inputs: id (required).

diagnosticar_consultaA

Analisa o objetivo do usuário e sugere o melhor fluxo de ferramentas a usar. Use esta ferramenta quando não souber qual ferramenta escolher ou quiser evitar erros.

Inputs: objetivo (required).

discursos_deputadoC

Lista os discursos de um deputado

Inputs: id (required), dataInicio, dataFim, keywords, +2 more.

eventos_deputadoC

Lista os eventos de que um deputado participou

Inputs: id (required), dataInicio, dataFim, pagina, +1 more.

eventos_orgaoC

Lista os eventos de um órgão da Câmara

Inputs: id (required), idTipoEvento, dataInicio, dataFim, +2 more.

exportar_dadosC

Exporta dados de outras ferramentas em diferentes formatos (JSON, CSV, Markdown)

Inputs: tool (required), params (required), formato, incluirMetadados.

frentes_deputadoC

Lista as frentes parlamentares das quais um deputado é membro

Inputs: id (required).

historico_votos_deputadoA

Retorna o histórico de votos de um deputado específico com análise completa.

Responde perguntas como:

  • "Como o deputado X votou nas últimas sessões?"

  • "Em quais temas o deputado X vota a favor?"

  • "O deputado X vota alinhado com o governo?"

  • "O deputado X segue a orientação do partido?"

Retorna:

  • Lista das últimas votações com o voto do deputado

  • Resumo (total a favor, contra, abstenções)

  • Alinhamento com orientações do Governo e do Partido

  • Análise por temas (tributação, saúde, educação, etc.)

Use buscar_deputados primeiro para obter o ID do deputado.

Inputs: idDeputado (required), dataInicio, dataFim, itens.

lideres_partidoB

Lista os líderes de um partido na Câmara

Inputs: id (required).

membros_frenteB

Lista os membros de uma frente parlamentar

Inputs: id (required).

membros_orgaoC

Lista os membros de um órgão da Câmara

Inputs: id (required), dataInicio, dataFim, pagina, +1 more.

membros_partidoC

Lista os membros (deputados) de um partido

Inputs: id (required), dataInicio, dataFim, idLegislatura, +2 more.

mesa_legislaturaB

Obtém a composição da mesa diretora de uma legislatura

Inputs: idLegislatura (required), dataInicio, dataFim.

obter_perfil_completo_deputadoA

Obtém TODOS os dados de um deputado (detalhes, despesas recentes, discursos, frentes, órgãos, etc) em uma única chamada paralela. Use isso preferencialmente para responder perguntas gerais sobre um parlamentar.

Inputs: id (required).

ocupacoes_deputadoB

Lista as ocupações registradas de um deputado

Inputs: id (required).

orgaos_deputadoC

Lista os órgãos dos quais um deputado é membro

Inputs: id (required), dataInicio, dataFim, pagina, +1 more.

orgaos_eventoB

Lista os órgãos relacionados a um evento

Inputs: id (required).

orientacoes_votacaoC

Lista as orientações de bancada em uma votação específica

Inputs: id (required).

pauta_eventoB

Obtém a pauta de um evento (proposições a serem discutidas/votadas)

Inputs: id (required).

profissoes_deputadoB

Lista as profissões registradas de um deputado

Inputs: id (required).

ranking_partidos_tamanhoA

Retorna o ranking dos maiores partidos na Câmara por número de deputados. Ideal para perguntas como "Quais os maiores partidos?", "Qual o maior partido?", "Quantos deputados tem cada partido?".

Inputs: confirmar (required), idLegislatura, limite.

ranking_proposicoes_autorC

Gera ranking de deputados por quantidade de proposições apresentadas, aprovadas ou em tramitação

Inputs: idDeputado, ano, tipoRanking.

relacionadas_proposicaoC

Lista as proposições relacionadas a uma proposição

Inputs: id (required).

resumo_despesas_deputadoA

Retorna um RESUMO OTIMIZADO das despesas de um deputado, ideal para agentes com limitações de contexto.

Ao invés de retornar centenas de documentos fiscais individuais, retorna:

  • Total gasto agregado por TIPO de despesa (ex: passagens, combustíveis, etc.)

  • Top 10 maiores gastos individuais

  • Estatísticas (total, média, quantidade de documentos)

Use esta ferramenta preferencialmente ao invés de 'despesas_deputado' quando precisar de visão geral. Use 'despesas_deputado' apenas se precisar ver TODOS os documentos detalhados.

Inputs: id (required), ano, mes, tipoDespesa.

resumo_discursos_deputadoA

Retorna um RESUMO OTIMIZADO dos discursos de um deputado, ideal para agentes com limitações de contexto.

Ao invés de retornar o texto completo de dezenas/centenas de discursos (que pode exceder 500KB), retorna:

  • Estatísticas gerais (total, distribuição por tema e tipo)

  • Palavras-chave mais frequentes nos discursos

  • Top 10 discursos mais recentes/relevantes RESUMIDOS (~150 palavras cada)

  • Agrupamento por tema detectado automaticamente

Use esta ferramenta preferencialmente ao invés de 'discursos_deputado' quando precisar de visão geral. Use 'discursos_deputado' apenas se precisar ler textos completos de discursos específicos.

Inputs: id (required), dataInicio, dataFim, keywords.

resumo_tramitacao_proposicaoA

Retorna um RESUMO OTIMIZADO do histórico de tramitação de uma proposição, ideal para agentes com limitações de contexto.

Ao invés de retornar todas as centenas de tramitações (muitas repetitivas), retorna:

  • Estatísticas gerais (total de tramitações, tempo de tramitação, status atual)

  • Apenas EVENTOS-CHAVE: apresentação, designações, aprovações, votações, sanções (máximo 20)

  • Lista de comissões por onde passou, com status e tempo de tramitação

  • Timeline resumida focada nos marcos importantes

Use esta ferramenta preferencialmente ao invés de 'tramitacoes_proposicao' quando precisar de visão geral. Use 'tramitacoes_proposicao' apenas se precisar ver TODOS os despachos e movimentações detalhadas de um período específico.

Inputs: id (required), dataInicio, dataFim.

situacoes_proposicaoA

Lista as situações possíveis de proposições legislativas (tramitando, arquivada, aprovada, etc). Use esta tool para obter o ID ou sigla de uma situação quando precisar filtrar proposições por status em buscar_proposicoes. Exemplos de uso: encontrar proposições em tramitação, listar PLs arquivados, buscar PECs aprovadas.

Inputs: no named parameters.

sugerir_ferramentasA

Sugere quais ferramentas usar para uma determinada consulta sobre a Câmara dos Deputados. Use antes de fazer consultas complexas para entender o melhor caminho.

Inputs: consulta (required).

temas_proposicaoC

Lista os temas de uma proposição

Inputs: id (required).

timeline_tramitacaoC

Gera uma linha do tempo visual da tramitação de uma proposição com marcos importantes e estatísticas

Inputs: idProposicao (required), formato.

tipos_eventoA

Lista os tipos de eventos realizados na Câmara. Inclui: sessões plenárias (deliberativas, não deliberativas), reuniões de comissão, audiências públicas, seminários, etc. Use para filtrar eventos específicos em buscar_eventos ou entender a agenda legislativa.

Inputs: no named parameters.

tipos_orgaoA

Lista os tipos de órgãos da Câmara dos Deputados. Inclui: comissões permanentes (CCJC, CFT), comissões especiais, CPIs, Mesa Diretora, Plenário, etc. Use para filtrar órgãos por tipo em buscar_orgaos ou entender a estrutura organizacional da Câmara.

Inputs: no named parameters.

tipos_proposicaoA

Lista todos os tipos de proposições legislativas com siglas e descrições. Tipos comuns: PL (Projeto de Lei), PEC (Emenda Constitucional), MPV (Medida Provisória), PDL (Decreto Legislativo), PLP (Lei Complementar). Use para descobrir a sigla correta ao buscar proposições com buscar_proposicoes.

Inputs: no named parameters.

tramitacoes_proposicaoC

Lista o histórico de tramitações de uma proposição

Inputs: id (required), dataInicio, dataFim, pagina, +1 more.

ufsA

Lista todas as Unidades Federativas (estados) do Brasil com siglas e nomes completos. Use para validar siglas de UF ou obter a lista completa de estados ao filtrar deputados por região em buscar_deputados.

Inputs: no named parameters.

ultimas_votacoesC

Lista as últimas votações realizadas na Câmara dos Deputados

Inputs: ordem.

votacoes_eventoC

Lista as votações ocorridas em um evento

Inputs: id (required).

votacoes_orgaoC

Lista as votações de um órgão da Câmara

Inputs: id (required), idProposicao, dataInicio, dataFim, +2 more.

votacoes_proposicaoC

Lista as votações relacionadas a uma proposição

Inputs: id (required), ordem, ordenarPor.

votos_votacaoB

Lista os votos de deputados em uma votação específica

Inputs: id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 63 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific resources and actions (e.g., buscar_deputados vs. detalhar_deputado), but there is some overlap between diagnosticar_consulta and sugerir_ferramentas, both suggesting tool usage. Additionally, resumo_* tools provide optimized versions of detailed tools (e.g., resumo_despesas_deputado vs. despesas_deputado), which could cause confusion if not carefully described, though descriptions help clarify.

    Naming Consistency5/5

    Tool names follow a highly consistent snake_case pattern with clear verb_noun structures throughout (e.g., buscar_deputados, detalhar_evento, analise_despesas_partido). There are no deviations in naming conventions, making the set predictable and easy to parse for agents.

    Tool Count2/5

    With 63 tools, the count is excessive for a single server, even given the broad domain of legislative data. This many tools can overwhelm agents, increase complexity, and likely includes redundancy (e.g., multiple summary vs. detailed tools). A more focused set of 15-30 tools would be more appropriate for usability.

    Completeness5/5

    The tool set provides comprehensive coverage for the Brazilian Chamber of Deputies domain, including CRUD-like operations (buscar, detalhar), analyses (analise_*, ranking_*), summaries (resumo_*), and utilities (exportar_dados, ufs). There are no obvious gaps; it supports full workflows for deputies, propositions, events, votes, and more.

    Related MCP Connectors