consultar_prestador_contas
Retrieve campaign finance records for Brazilian political candidates using election codes, year, municipality, position, and candidate identifiers.
Instructions
Consulta informações sobre prestação de contas de um candidato
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eleicao | Yes | Código da eleição | |
| ano | Yes | Ano da eleição (ex: 2020) | |
| municipio | Yes | Código do município | |
| cargo | Yes | Código do cargo | |
| candidato | Yes | Código do candidato |
Implementation Reference
- src/index.ts:354-374 (handler)Handler function for the 'consultar_prestador_contas' tool. Parses input using ConsultaPrestadorSchema, makes API call to fetch prestação de contas data, and formats the response.
case "consultar_prestador_contas": { const params = ConsultaPrestadorSchema.parse(args); const data = await handleApiRequest(() => httpClient.get(`/prestador/consulta/${params.eleicao}/${params.ano}/${params.municipio}/${params.cargo}/90/90/${params.candidato}`) ); return { content: [ { type: "text", text: `Informações de prestação de contas:\n\n` + `Candidato: ${data.nomeCompleto || 'N/A'}\n` + `Partido: ${data.nomePartido || 'N/A'} (${data.siglaPartido || 'N/A'})\n` + `CNPJ: ${data.cnpj || 'N/A'}\n` + `Total Recebido: R$ ${data.dadosConsolidados?.totalRecebido || 0}\n` + `Total Despesas: R$ ${data.despesas?.totalDespesasPagas || 0}\n\n` + `Detalhes completos:\n${JSON.stringify(data, null, 2)}` } ] }; } - src/index.ts:51-57 (schema)Zod schema for validating input parameters of the 'consultar_prestador_contas' tool.
const ConsultaPrestadorSchema = z.object({ eleicao: z.number().int(), ano: z.number().int().min(2000).max(new Date().getFullYear()), municipio: z.number().int(), cargo: z.number().int(), candidato: z.number().int() }); - src/index.ts:205-236 (registration)Tool registration in the ListTools response, including name, description, and input schema.
{ name: "consultar_prestador_contas", description: "Consulta informações sobre prestação de contas de um candidato", inputSchema: { type: "object", properties: { eleicao: { type: "number", description: "Código da eleição" }, 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" }, cargo: { type: "number", description: "Código do cargo" }, candidato: { type: "number", description: "Código do candidato" } }, required: ["eleicao", "ano", "municipio", "cargo", "candidato"] } }