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/).
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.jsNo Claude Desktop, abra o arquivo claude_desktop_config.json (no Mac: Library/Application Support/Claude), acrescente o bloco abaixo e reinicie o aplicativo.
{
"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.