listar_eleicoes_suplementares
Retrieve supplementary elections data for specific Brazilian states and years to access official electoral information from TSE's API.
Instructions
Lista eleições suplementares em um estado e ano específicos
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ano | Yes | Ano da eleição (ex: 2020) | |
| uf | Yes | Sigla da unidade federativa (ex: SP, RJ) |
Input Schema (JSON Schema)
{
"properties": {
"ano": {
"description": "Ano da eleição (ex: 2020)",
"maximum": 2025,
"minimum": 2000,
"type": "number"
},
"uf": {
"description": "Sigla da unidade federativa (ex: SP, RJ)",
"pattern": "^[A-Z]{2}$",
"type": "string"
}
},
"required": [
"ano",
"uf"
],
"type": "object"
}
Implementation Reference
- src/index.ts:337-352 (handler)Handler function for the 'listar_eleicoes_suplementares' tool. Validates input parameters using EleicoesSuplementaresEstadoSchema, makes an API call to fetch supplementary elections for a given year and state (UF), and returns the formatted results.case "listar_eleicoes_suplementares": { const params = EleicoesSuplementaresEstadoSchema.parse(args); const data = await handleApiRequest(() => httpClient.get(`/eleicao/suplementares/${params.ano}/${params.uf}`) ); return { content: [ { type: "text", text: `Eleições suplementares em ${params.uf} (${params.ano}): ${data.length}\n\n` + JSON.stringify(data, null, 2) } ] }; }
- src/index.ts:46-49 (schema)Zod schema definition for input validation of the 'listar_eleicoes_suplementares' tool, defining 'ano' (year) and 'uf' (state code) parameters.const EleicoesSuplementaresEstadoSchema = z.object({ ano: z.number().int().min(2000).max(new Date().getFullYear()), uf: z.string().length(2) });
- src/index.ts:184-204 (registration)Tool registration in the ListTools response, providing name, description, and input schema for 'listar_eleicoes_suplementares'.{ name: "listar_eleicoes_suplementares", description: "Lista eleições suplementares em um estado e ano específicos", inputSchema: { type: "object", properties: { ano: { type: "number", description: "Ano da eleição (ex: 2020)", minimum: 2000, maximum: new Date().getFullYear() }, uf: { type: "string", description: "Sigla da unidade federativa (ex: SP, RJ)", pattern: "^[A-Z]{2}$" } }, required: ["ano", "uf"] } },