Camara BR

You have a dedicated MCP Server that exposes the Câmara dos Deputados Open Data API through typed, validated tools optimized for use with Large Language Models. This server is designed for deterministic, type-safe access to legislative data, with built-in caching, rate limiting, and observability to help you build reliable LLM-powered workflows.

How to use

You interact with the MCP Server by pointing your MCP client at the local or remote MCP entry points and invoking tools that match your data needs. Each tool is designed to take structured inputs and return clearly typed results that your LLM can reason about. Begin by selecting a deputy, proposition, voting record, or any other supported data object, then compose tool calls in your MCP client to fetch, filter, or analyze information from the Câmara API.

How to install

Prerequisites: Node.js version 20 or newer, and npm or yarn. Ensure you can run Node commands from your shell.

Install dependencies and build the server the way you typically deploy Node-based MCP servers.

# 1. Install dependencies
npm install

# 2. Build the MCP server
npm run build

# 3. Start the server (example for local development)
npm start

Configuration and quick start for Claude Desktop

Edit the configuration file used by your MCP client to register the camara-br MCP server. The following example shows how to configure a local stdio server that runs the compiled server script.

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

Windows-specific configuration note

If you are on Windows, use double backslashes in file paths when placing the server script path in the configuration.

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

Reiniciar Claude Desktop

After updating the configuration, close Claude Desktop and reopen it so the MCP server registration takes effect.

Additional configuration notes

Configure environment and runtime behavior as needed for your deployment. Most deployments will enable basic API loading, caching, rate limiting, and metrics to observe performance and reliability.

Examples and usage notes

Use the available tools to query deputies, propositions, votes, events, and more. Compose tool calls that align with your data needs and the type-safe responses will help you build robust LLM prompts and reasoning steps.

Monitoring and observability

The MCP server includes metrics and health indicators to monitor runtime behavior, throughput, and error rates. Use the exposed metrics endpoint to integrate with your Prometheus-based dashboards and alerting.

Troubleshooting

If you encounter startup or runtime issues, verify that the server.js path exists, the Node binary is accessible, and the configuration is loaded by Claude Desktop. Check logs for startup errors, network connectivity, and any validation errors produced by tools.

Security and access control

Limit access to the MCP endpoints in production. Use standard practice for protecting local or remote MCP endpoints, including network controls, authentication where applicable, and least-privilege permissions for the runtime user.

Available tools

sugerir_ferramentas

Suggests which tools to use for a given query.

diagnosticar_consulta

Analyzes the goal of a query and suggests a complete tool flow.

buscar_deputados

Search deputies by name, UF, party, and other filters.

detalhar_deputado

Provide detailed information about a specific deputy.

despesas_deputado

Return expenses of a deputy, typically from parliamentary allowances.

discursos_deputado

List speeches given by a deputy.

eventos_deputado

Show events a deputy participated in.

frentes_deputado

List parliamentary fronts the deputy is a member of.

ocupacoes_deputado

Historical occupations of a deputy.

orgaos_deputado

Organizations or committees the deputy belongs to.

profissoes_deputado

Declared professions of a deputy.

buscar_proposicoes

Search legislative propositions (PL, PEC, MP, etc.).

detalhar_proposicao

Detailed information about a proposition.

autores_proposicao

List authors of a proposition.

tramitacoes_proposicao

History of the proposition's tramitation.

votacoes_proposicao

Votes related to a proposition.

relacionadas_proposicao

Propositions related to a given proposition.

temas_proposicao

Themes or subjects of a proposition.

buscar_votacoes

Search votes by period or proposition.

detalhar_votacao

Overall result of a vote.

votos_votacao

Individual deputy votes within a vote.

orientacoes_votacao

Parties’ orientations for a vote.

ultimas_votacoes

Most recent voting sessions.

buscar_eventos

Search meetings and sessions by period.

detalhar_evento

Details of a specific event.

deputados_evento

Deputies present at an event.

pauta_evento

Agenda of an event.

votacoes_evento

Votes that occurred at an event.

orgaos_evento

Organizations involved in an event.

buscar_orgaos

Search committees and other bodies.

detalhar_orgao

Details about an organization.

membros_orgao

Current members of an organization.

eventos_orgao

Events associated with an organization.

votacoes_orgao

Votes associated with an organization.

buscar_partidos

List political parties.

detalhar_partido

Details about a party.

membros_partido

Deputies belonging to a party.

lideres_partido

Party leadership information.

buscar_frentes

Search parliamentary fronts.

detalhar_frente

Details about a parliamentary front.

membros_frente

Members of a parliamentary front.

buscar_blocos

Search parliamentary blocs.

detalhar_bloco

Details about a bloc.

buscar_legislaturas

List legislative sessions.

detalhar_legislatura

Details about a legislative session.

mesa_legislatura

Leadership of a legislative session.

situacoes_proposicao

Possible statuses of propositions.

tipos_proposicao

Types of propositions (PL, PEC, etc.).

tipos_orgao

Types of Câmara organs.

tipos_evento

Types of events.

ufs

Federal state abbreviations.

analise_presenca

Presence rate of deputies.

ranking_proposicoes

Ranking of propositions by various metrics.

analise_despesas_partido

Aggregated expenses by party.

comparativo_votacoes

Compare voting records across propositions.

timeline_tramitacao

Timeline of proposition tramitation.

exportar_dados

Export data to CSV/JSON.