listar_cargos_municipio
Retrieve contested political positions for a specific municipality in Brazilian elections using election and municipality codes.
Instructions
Lista os cargos em disputa em um município específico
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"eleicao": "<eleicao>",
"municipio": "<municipio>"
},
"name": "listar_cargos_municipio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eleicao | Yes | Código da eleição | |
| municipio | Yes | Código do município |
Implementation Reference
- src/index.ts:301-319 (handler)Handler for the 'listar_cargos_municipio' tool: parses arguments with Zod schema, calls the TSE API to fetch cargos for a specific election and municipality, formats and returns the response.
case "listar_cargos_municipio": { const params = CargosMunicipioSchema.parse(args); const data = await handleApiRequest(() => httpClient.get(`/eleicao/listar/municipios/${params.eleicao}/${params.municipio}/cargos`) ); return { content: [ { type: "text", text: `Cargos em disputa no município:\n\n` + `Município: ${data.unidadeEleitoralDTO?.nome || 'N/A'}\n` + `UF: ${data.unidadeEleitoralDTO?.sigla || 'N/A'}\n` + `Cargos disponíveis: ${data.cargos?.length || 0}\n\n` + JSON.stringify(data, null, 2) } ] }; } - src/index.ts:157-174 (registration)Registration of the 'listar_cargos_municipio' tool in the ListToolsRequestHandler, including name, description, and input schema.
{ name: "listar_cargos_municipio", description: "Lista os cargos em disputa em um município específico", inputSchema: { type: "object", properties: { eleicao: { type: "number", description: "Código da eleição" }, municipio: { type: "number", description: "Código do município" } }, required: ["eleicao", "municipio"] } }, - src/index.ts:41-44 (schema)Zod schema used in the handler for validating the input parameters (eleicao and municipio) for the 'listar_cargos_municipio' tool.
const CargosMunicipioSchema = z.object({ eleicao: z.number().int(), municipio: z.number().int() });