Pular para o conteúdo
Segue o Voto

Consulte pelo seu assistente de IA

Um servidor MCP deixa o Claude (ou outro assistente compatível) buscar políticos, votos e gastos nas mesmas fontes oficiais do site, sem copiar e colar.

O que é

MCP é um padrão para ligar assistentes de IA a fontes de dados. Instalado, o seu assistente ganha seis ferramentas de consulta. Você pergunta em português (“quem me representa em Campinas?”), ele chama a ferramenta certa e responde com o que o banco do site tem.

O servidor lê o mesmo banco que alimenta as páginas daqui. Cada resposta traz a fonte oficial e a data da carga; o que a fonte não publica vem como “—” e o motivo, nunca como zero.

O que ele garante

  • Somente leitura: usa uma conta do banco que só consulta, e a sessão recusa qualquer escrita.
  • Descreve e não avalia: nenhuma ferramenta dá nota, ranking ou veredito sobre uma pessoa. As listas saem em ordem alfabética ou por data.
  • Sem CPF, sem endereço e sem doador pessoa física. Fornecedor só aparece se for empresa (CNPJ).
  • Limite de linhas por resposta e tempo máximo por consulta; erro de nome ou cidade volta com sugestões.

As regras de contagem (presença, o traço no lugar do zero, neutralidade) são as de Metodologia e fontes.

As seis ferramentas

  • buscar_politico(nome, uf?, cargo?)

    Acha quem tem mandato atual pelo nome. Devolve slug, nome, cargo, partido e UF, em ordem alfabética.

    Exemplo de pergunta: “Quem é a deputada Adriana Ventura?”

  • ver_politico(slug)

    O resumo do crachá: mandatos, salário (diz se é o teto ou o valor pago), patrimônio declarado por eleição, presença com a regra de contagem, propostas, votos e a cota do ano.

    Exemplo de pergunta: “Mostre o crachá de adriana-ventura.”

  • quem_me_representa(cidade, uf)

    Os representantes em exercício de uma cidade, por nível: a cidade, o estado e Brasília.

    Exemplo de pergunta: “Quem me representa em Campinas, SP?”

  • como_votou(slug, tema?, ano?)

    Votos nominais, do mais recente ao mais antigo, com tema, voto, resultado e placar.

    Exemplo de pergunta: “Como ela votou em saúde em 2025?”

  • comparar_votos(slug_a, slug_b, ano?)

    Em quantas votações nominais em comum os dois votaram igual, e as divergências mais recentes. Mede coincidência, não qualidade.

    Exemplo de pergunta: “Compare os votos de dois deputados em 2025.”

  • gastos_cota(slug, ano)

    A cota parlamentar de um ano: total, categorias e os dez maiores fornecedores pessoa jurídica, em ordem alfabética.

    Exemplo de pergunta: “Em que ela gastou a cota em 2025?”

Como instalar

Hoje o servidor roda na sua máquina, apontando para o banco do projeto. Ainda não existe um endereço público para conectar de fora: hospedar o servidor depende de deploy e de uma decisão do responsável pelo site. Precisa de Node 20 ou mais novo e do código do repositório (pasta mcp/).

Claude Code
cd mcp && npm install && npm run build
claude mcp add civico \
  -e CIVICO_DATABASE_URL=postgres://web_reader:web_reader@localhost:54329/civico \
  -- node /CAMINHO/ATÉ/replica/mcp/dist/stdio.js

No Claude Desktop, abra o arquivo claude_desktop_config.json (no Mac: Library/Application Support/Claude), acrescente o bloco abaixo e reinicie o aplicativo.

Claude Desktop
{
  "mcpServers": {
    "civico": {
      "command": "node",
      "args": ["/CAMINHO/ATÉ/replica/mcp/dist/stdio.js"],
      "env": {
        "CIVICO_DATABASE_URL": "postgres://web_reader:web_reader@localhost:54329/civico"
      }
    }
  }
}

Troque /CAMINHO/ATÉ pelo caminho real. O servidor só aceita a conta de leitura web_reader; com outra conta ele não sobe. O passo a passo completo, as variáveis e o modo HTTP local estão em mcp/README.md.

Prefere ver no navegador? Achar quem representa a sua cidade ou ver quem publica dados e o que ainda falta.