mcp-camara-server

thomaschi78/mcp-camara-server

3.2

If you are the rightful owner of mcp-camara-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MCP Câmara Server provides access to legislative data from the Brazilian Chamber of Deputies Open Data API.

Tools
11
Resources
0
Prompts
0

MCP Câmara Server

MCP (Model Context Protocol) server for accessing the Brazilian Chamber of Deputies Open Data API (Dados Abertos da Câmara dos Deputados).

Overview

This MCP server provides access to comprehensive legislative data from the Brazilian Chamber of Deputies, including:

  • Deputies (Deputados): Information about current and past representatives
  • Propositions (Proposições): Legislative bills, amendments, and proposals
  • Parties (Partidos): Political party information
  • Events (Eventos): Legislative sessions, hearings, and meetings
  • Organs (Órgãos): Committees and legislative bodies
  • Votes (Votações): Voting records and results
  • Expenses (Despesas): Parliamentary activity expenses

Installation

npm install
npm run build

Configuration

Add this to your Claude Code MCP settings file (~/.claude.json or similar):

{
  "mcpServers": {
    "camara-dados-abertos": {
      "command": "node",
      "args": ["/path/to/mcp-camara-server/dist/index.js"]
    }
  }
}

Available Tools

Deputies

list_deputados

List deputies with optional filtering.

Parameters:

  • nome: Filter by name (partial match)
  • idLegislatura: Filter by legislature ID (e.g., 57 for 2023-2027)
  • siglaUf: Filter by state (e.g., SP, RJ, MG)
  • siglaPartido: Filter by party (e.g., PT, PSDB, PL)
  • siglaSexo: Filter by gender (M or F)
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number (default: 1)
  • itens: Items per page (default: 15, max: 100)

Example:

list_deputados({
  siglaUf: "SP",
  siglaPartido: "PT",
  itens: 50
})
get_deputado_details

Get detailed information about a specific deputy.

Parameters:

  • id: Deputy ID (required)
get_deputado_despesas

Get expense records for a specific deputy.

Parameters:

  • id: Deputy ID (required)
  • ano: Year (e.g., 2024)
  • mes: Month (1-12)
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number
  • itens: Items per page

Propositions

list_proposicoes

Search for legislative propositions. By default shows propositions from the last 30 days.

Parameters:

  • siglaTipo: Proposition type (e.g., PL for bill, PEC for constitutional amendment)
  • numero: Proposition number
  • ano: Year
  • dataInicio: Start date (YYYY-MM-DD)
  • dataFim: End date (YYYY-MM-DD)
  • idDeputadoAutor: Author deputy ID
  • siglaPartidoAutor: Author's party
  • siglaUfAutor: Author's state
  • keywords: Search keywords
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number
  • itens: Items per page (max: 100)

Example:

list_proposicoes({
  siglaTipo: "PL",
  ano: 2024,
  keywords: "educação",
  itens: 20
})
get_proposicao_details

Get detailed information about a specific proposition.

Parameters:

  • id: Proposition ID (required)

Political Parties

list_partidos

List political parties.

Parameters:

  • idLegislatura: Legislature ID
  • dataInicio: Start date (YYYY-MM-DD)
  • dataFim: End date (YYYY-MM-DD)
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number
  • itens: Items per page

Events

list_eventos

List legislative events. By default shows events 5 days before and after current date.

Parameters:

  • id: Event ID
  • idOrgao: Legislative organ ID
  • dataInicio: Start date (YYYY-MM-DD)
  • dataFim: End date (YYYY-MM-DD)
  • horaInicio: Start time (HH:MM)
  • horaFim: End time (HH:MM)
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number
  • itens: Items per page

Example:

list_eventos({
  dataInicio: "2024-01-01",
  dataFim: "2024-01-31"
})
get_evento_details

Get detailed information about a specific event.

Parameters:

  • id: Event ID (required)

Legislative Organs

list_orgaos

List legislative organs (committees, commissions, etc.).

Parameters:

  • idTipoOrgao: Organ type ID
  • dataInicio: Start date (YYYY-MM-DD)
  • dataFim: End date (YYYY-MM-DD)
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number
  • itens: Items per page

Voting

list_votacoes

List voting records.

Parameters:

  • id: Voting ID
  • idOrgao: Organ ID
  • idProposicao: Proposition ID
  • dataInicio: Start date (YYYY-MM-DD)
  • dataFim: End date (YYYY-MM-DD)
  • ordenarPor: Field to sort by
  • ordem: Sort order (ASC or DESC)
  • pagina: Page number
  • itens: Items per page

Example:

list_votacoes({
  dataInicio: "2024-01-01",
  dataFim: "2024-12-31"
})
get_votacao_details

Get detailed information about a specific voting session.

Parameters:

  • id: Voting ID (required)

Usage Examples

Find deputies from São Paulo state in PT party

list_deputados({
  siglaUf: "SP",
  siglaPartido: "PT"
})

Search for education bills from 2024

list_proposicoes({
  siglaTipo: "PL",
  ano: 2024,
  keywords: "educação"
})

Get upcoming legislative events

list_eventos({
  dataInicio: "2025-01-01",
  dataFim: "2025-01-31"
})

Get deputy expenses for a specific month

get_deputado_despesas({
  id: 178957,
  ano: 2024,
  mes: 1
})

API Reference

This server uses the official Câmara dos Deputados Open Data API v2:

Data Format

All responses are returned in JSON format matching the official API structure. Each list endpoint returns:

  • dados: Array of results
  • links: Pagination links
  • Metadata about the request

Common State Abbreviations (UF)

  • SP: São Paulo
  • RJ: Rio de Janeiro
  • MG: Minas Gerais
  • BA: Bahia
  • RS: Rio Grande do Sul
  • PR: Paraná
  • PE: Pernambuco
  • CE: Ceará
  • PA: Pará
  • SC: Santa Catarina
  • GO: Goiás
  • PB: Paraíba
  • ES: Espírito Santo
  • AM: Amazonas
  • RN: Rio Grande do Norte
  • And others...

Common Proposition Types

  • PL: Projeto de Lei (Bill)
  • PEC: Proposta de Emenda à Constituição (Constitutional Amendment)
  • PLP: Projeto de Lei Complementar (Complementary Law Bill)
  • PDC: Projeto de Decreto Legislativo (Legislative Decree)
  • PRC: Projeto de Resolução da Câmara (Chamber Resolution)
  • MPV: Medida Provisória (Provisional Measure)

License

MIT

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Links