MCP Câmara BR
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Câmara BR buscar deputados do estado de São Paulo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🏛️ 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 install2. Compilar
npm run build3. Configurar no Claude Desktop
Edite o arquivo de configuração:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.jsonAdicione 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:
Windows 11/10: Veja o Guia de Instalação para Windows
macOS/Linux: Continue com as instruções abaixo ou veja o Guia de Instalação Completo
Início Rápido: Para desenvolvedores experientes, veja Início Rápido
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 startUso com Docker
# Build da imagem
docker-compose build
# Executar
docker-compose up -d
# Ver logs
docker-compose logs -f
# Parar
docker-compose downUso 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:httpEndpoints HTTP
GET /- Informações da APIGET /api/tools- Lista todas as ferramentas disponíveisPOST /api/tools/:toolName- Executa uma ferramentaGET /health- Health checkGET /metrics- Métricas PrometheusGET /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 consultadiagnosticar_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 deputadodespesas_deputado- Despesas da cota parlamentardiscursos_deputado- Discursos proferidoseventos_deputado- Eventos que participoufrentes_deputado- Frentes parlamentares das quais é membroocupacoes_deputado- Histórico de ocupações na Câmaraorgaos_deputado- Órgãos dos quais é membroprofissoes_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çãoautores_proposicao- Lista os autores de uma proposiçãotramitacoes_proposicao- Histórico de tramitaçãovotacoes_proposicao- Votações da proposiçãorelacionadas_proposicao- Proposições relacionadastemas_proposicao- Temas/assuntos da proposição
Votações (5)
buscar_votacoes- Busca votações por período ou proposiçãodetalhar_votacao- Resultado geral de uma votaçãovotos_votacao- Voto individual de cada deputadoorientacoes_votacao- Orientação dos partidosultimas_votacoes- Votações mais recentes
Eventos (6)
buscar_eventos- Busca reuniões e sessões por períododetalhar_evento- Informações de um eventodeputados_evento- Deputados presentespauta_evento- Pauta do eventovotacoes_evento- Votações realizadasorgaos_evento- Órgãos participantes
Órgãos (5)
buscar_orgaos- Busca comissões e órgãosdetalhar_orgao- Informações de um órgãomembros_orgao- Composição atualeventos_orgao- Eventos do órgãovotacoes_orgao- Votações do órgão
Partidos (4)
buscar_partidos- Lista partidosdetalhar_partido- Informações de um partidomembros_partido- Deputados do partidolideres_partido- Liderança do partido
Frentes Parlamentares (3)
buscar_frentes- Busca frentes parlamentaresdetalhar_frente- Informações de uma frentemembros_frente- Membros da frente
Blocos (2)
buscar_blocos- Busca blocos partidáriosdetalhar_bloco- Informações de um bloco
Legislaturas (3)
buscar_legislaturas- Lista legislaturasdetalhar_legislatura- Informações de uma legislaturamesa_legislatura- Mesa Diretora
Referências (5)
situacoes_proposicao- Situações possíveis de proposiçõestipos_proposicao- Tipos de proposições (PL, PEC, etc.)tipos_orgao- Tipos de órgãos da Câmaratipos_evento- Tipos de eventosufs- Unidades Federativas
Análises (6)
analise_presenca- Taxa de presença de deputadosranking_proposicoes- Ranking de proposiçõesanalise_despesas_partido- Despesas agregadas por partidocomparativo_votacoes- Compara votaçõestimeline_tramitacao- Timeline de tramitaçãoexportar_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 PTOu 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 2024Ou 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çãoDespesas de um Deputado
Mostre as despesas do deputado Guilherme Boulos em janeiro de 2024Ou 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/healthLogs
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 MITDesenvolvimento
# 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/developrelease.yml- Executado ao criar tags (v*)
📚 Documentação Completa
Guias
Início Rápido - Comece em 5 minutos
Guia de Instalação e Uso - Instalação e configuração completas
Exemplos e Testes
Exemplos Práticos - Casos de uso com LLMs
Exemplos de Testes - Validação e testes
Especificações
Especificação Técnica Completa - Documentação técnica detalhada
Integrações
Sistema Multi-Agentes n8n - Arquitetura de orquestração de agentes especialistas
Para Desenvolvedores
Guia de Contribuição - Como contribuir com o projeto
Guia para IA (CLAUDE.md) - Instruções para assistentes de IA
Índice Completo
Documentação Organizada - Índice completo de toda documentação
🤝 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:
Fork o projeto
Crie uma branch para sua feature (
git checkout -b feature/MinhaFeature)Siga os padrões de código (TypeScript strict, ESLint, Prettier)
Escreva testes para novas funcionalidades
Commit usando Conventional Commits (
feat:,fix:, etc.)Push para a branch (
git push origin feature/MinhaFeature)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 PrettierLicença
MIT License - veja o arquivo LICENSE para detalhes.
🔗 Links
Suporte
Para reportar bugs ou solicitar features, abra uma issue.
Desenvolvido com ❤️ para democratização de dados públicos
Available Tools
63 toolsanalise_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
Scored across 63 tools
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.
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.
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.
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
Brazilian election and legislative data (MCP Político, MCP Legislativo) for Claude and ChatGPT.
IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.
U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.