listar_candidatos_municipio
Retrieve candidate lists for municipal elections in Brazil using official TSE data. Specify election year, municipality code, election code, and position code to get comprehensive candidate information.
Instructions
Lista todos os candidatos para eleições em um município específico
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ano | Yes | Ano da eleição (ex: 2020) | |
| municipio | Yes | Código do município (ex: 35157 para São Paulo) | |
| eleicao | Yes | Código da eleição (ex: 2030402020 para eleições municipais de 2020) | |
| cargo | Yes | Código do cargo |
Implementation Reference
- src/index.ts:247-262 (handler)Handler for the 'listar_candidatos_municipio' tool. Validates input using Zod schema, fetches candidate list from TSE API, and returns formatted JSON response.
case "listar_candidatos_municipio": { const params = CandidatosParaMunicipioSchema.parse(args); const data = await handleApiRequest(() => httpClient.get(`/candidatura/listar/${params.ano}/${params.municipio}/${params.eleicao}/${params.cargo}/candidatos`) ); return { content: [ { type: "text", text: `Candidatos encontrados: ${data.candidatos?.length || 0}\n\n` + JSON.stringify(data, null, 2) } ] }; } - src/index.ts:27-32 (schema)Zod schema for validating input parameters of the listar_candidatos_municipio tool.
const CandidatosParaMunicipioSchema = z.object({ ano: z.number().int().min(2000).max(new Date().getFullYear()), municipio: z.number().int(), eleicao: z.number().int(), cargo: z.number().int() }); - src/index.ts:92-119 (registration)Tool registration in the ListTools response, defining name, description, and input schema for MCP protocol.
{ name: "listar_candidatos_municipio", description: "Lista todos os candidatos para eleições em um município específico", inputSchema: { type: "object", properties: { ano: { type: "number", description: "Ano da eleição (ex: 2020)", minimum: 2000, maximum: new Date().getFullYear() }, municipio: { type: "number", description: "Código do município (ex: 35157 para São Paulo)" }, eleicao: { type: "number", description: "Código da eleição (ex: 2030402020 para eleições municipais de 2020)" }, cargo: { type: "number", description: "Código do cargo" } }, required: ["ano", "municipio", "eleicao", "cargo"] } },