Skip to main content
Glama

flaviometro-mcp

Servidor MCP (Model Context Protocol) local para consultar, direto do seu assistente de IA, os dados públicos do Flaviômetro, o site que acompanha ao vivo quais deputados, senadores, governadores e prefeitos do PL e aliados falam do Flávio Bolsonaro nas redes sociais.

Com ele você pergunta em português ao Claude (ou a outro cliente MCP) coisas como "quais senadores eleitos ainda não citaram o Flávio?" e recebe a resposta calculada em cima dos dados mais recentes do site.

WARNING

Projeto não oficial. Este repositório não tem nenhuma ligação com o Flaviômetro, seus autores, o PL, o Flávio Bolsonaro ou qualquer campanha. Ele não é mantido, endossado nem revisado pelo site.

Este projeto também não tem ligação com o TSE nem com o OpenCNPJ, usados pela ferramenta contato_campanha.

O Flaviômetro não oferece uma API pública. Este servidor lê o mesmo arquivo JSON que o navegador baixa ao abrir o site. Se o site mudar o formato, o servidor pode parar de funcionar sem aviso. Os números e classificações são do Flaviômetro; este projeto só os organiza.


Sumário


Related MCP server: mcp-brasil

O que dá para fazer

  • Ver o panorama geral: quantos políticos monitorados pediram voto, quantos só citaram, quantos postaram sem citar e quantos não postaram nada.

  • Filtrar políticos por nome, estado, cargo, partido, situação eleitoral e município.

  • Descobrir quem ficou em silêncio (postou no período, mas não falou do Flávio).

  • Abrir a ficha de um político: redes monitoradas, números por rede e os posts mais recentes em que citou o Flávio.

  • Listar e buscar posts por rede, período, texto da legenda ou trecho falado em vídeo.

  • Montar rankings por posts, pedidos de voto, visualizações ou interações.

  • Agregar os números por estado, partido, cargo, rede social ou dia.

  • Obter o contato da campanha de um candidato de 2026: o CNPJ de campanha (TSE) e o e-mail, telefone e endereço registrados na Receita Federal (via OpenCNPJ).

Ferramentas disponíveis

Ferramenta

Para que serve

Principais parâmetros

resumo_geral

Panorama do período, geral e por cargo

desde, ate

buscar_politicos

Lista políticos com filtros e status em relação ao Flávio

nome, uf, cargo, partido, situacao, municipio, status, ordenar_por, limite

detalhes_politico

Ficha completa de um político e seus posts recentes

politico (nome ou código sq), posts, incluir_posts_sem_citacao

listar_posts

Posts captados, com filtros e ordenação

filtros de político, rede, nivel_minimo, somente_fala_em_video, texto, desde, ate, ordenar_por, limite

ranking

Quem mais citou o Flávio segundo uma métrica

metrica, filtros de político, desde, ate, limite

estatisticas_agrupadas

Números agregados por grupo

agrupar_por (uf, partido, cargo, situacao, rede, dia)

contato_campanha

CNPJ de campanha (TSE) e e-mail/endereço registrados na Receita (OpenCNPJ)

politico (nome ou código sq)

legenda

Explica os códigos e a metodologia

—

atualizar_dados

Força novo download, ignorando o cache

—

Datas aceitam AAAA-MM-DD (interpretadas no horário de Brasília) ou ISO 8601 completo.

Requisitos

  • Node.js 20.18.1 ou mais recente (testado no 22)

  • Um cliente compatível com MCP: Claude Desktop, Claude Code, OpenCode, Cursor, VS Code, etc.

Instalação

git clone <url-deste-repositorio> flaviometro-mcp
cd flaviometro-mcp
npm install
npm run build

Isso gera o servidor em dist/index.js. Anote o caminho absoluto desse arquivo, ele vai na configuração do cliente. Para descobrir:

echo "$(pwd)/dist/index.js"

Configurando no seu cliente MCP

O servidor usa transporte stdio: o cliente inicia o processo e conversa com ele pela entrada e saída padrão. Não há porta nem servidor web.

Claude Code

claude mcp add flaviometro -- node /caminho/absoluto/flaviometro-mcp/dist/index.js

Confira com claude mcp list, ou digite /mcp dentro de uma sessão.

Em todos os exemplos abaixo, troque /caminho/absoluto/flaviometro-mcp/dist/index.js pelo caminho que você anotou na instalação. Caminhos relativos e ~ não funcionam.

Claude Desktop

  1. Abra o Claude Desktop e vá em Configurações → Desenvolvedor → Editar configuração. Isso abre (ou cria) o arquivo:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Adicione o servidor dentro de mcpServers. Se o arquivo já tiver outros servidores, inclua só a entrada flaviometro:

    {
      "mcpServers": {
        "flaviometro": {
          "command": "node",
          "args": ["/caminho/absoluto/flaviometro-mcp/dist/index.js"]
        }
      }
    }

    No Windows, escape as barras: "C:\\Users\\voce\\flaviometro-mcp\\dist\\index.js".

  3. Feche o Claude Desktop por completo (no macOS, Cmd+Q; só fechar a janela não basta) e abra de novo.

  4. Na caixa de mensagem, clique no ícone de ferramentas/conectores: o flaviometro deve aparecer com as 9 ferramentas. Na primeira vez que uma for usada, o Claude pede sua permissão.

Não apareceu? Em Configurações → Desenvolvedor o servidor aparece com o status e um botão para ver os logs. O erro mais comum é node não ser encontrado: nesse caso, use o caminho completo do Node em command (descubra com which node no macOS/Linux ou where node no Windows).

OpenCode

O OpenCode lê os servidores MCP da chave mcp do arquivo de configuração. Escolha onde colocar:

  • Global (vale para todos os projetos): ~/.config/opencode/opencode.json

  • Só em um projeto: opencode.json na raiz do projeto

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "flaviometro": {
      "type": "local",
      "command": ["node", "/caminho/absoluto/flaviometro-mcp/dist/index.js"],
      "enabled": true
    }
  }
}

Repare que, diferente dos outros clientes, no OpenCode o command é uma lista com o executável e os argumentos juntos. Variáveis de ambiente vão na chave environment:

"flaviometro": {
  "type": "local",
  "command": ["node", "/caminho/absoluto/flaviometro-mcp/dist/index.js"],
  "enabled": true,
  "environment": { "FLAVIOMETRO_CACHE_TTL_SEGUNDOS": "600" }
}

Se o arquivo já existir, junte a chave mcp com o que já estiver lá. Depois, reinicie o OpenCode e confira com:

opencode mcp list

O primeiro carregamento baixa alguns megabytes do site. Se o OpenCode reclamar de tempo esgotado ao listar as ferramentas, adicione "timeout": 20000 na entrada do servidor.

Cursor

O Cursor lê os servidores de um arquivo mcp.json:

  • Global (vale para todos os projetos): ~/.cursor/mcp.json

  • Só em um projeto: .cursor/mcp.json na raiz do projeto

{
  "mcpServers": {
    "flaviometro": {
      "type": "stdio",
      "command": "node",
      "args": ["/caminho/absoluto/flaviometro-mcp/dist/index.js"]
    }
  }
}

Variáveis de ambiente vão na chave env, como no Claude Desktop.

Depois de salvar:

  1. Abra as configurações do Cursor na área de MCP e confira se o flaviometro aparece com a chave ligada. Servidores desligados não carregam nem aparecem no chat.

  2. No chat em modo Agent, faça uma pergunta como "me dá um resumo do Flaviômetro". O Cursor pede confirmação antes de rodar cada ferramenta.

Deu erro? Abra o painel Output (Cmd+Shift+U no macOS, Ctrl+Shift+U no Windows/Linux) e escolha MCP Logs na lista. Ali aparecem a inicialização do servidor, as chamadas e os erros.

Outros clientes

Qualquer cliente que aceite servidores MCP via stdio funciona com o mesmo par command + args. No VS Code, por exemplo, o arquivo é .vscode/mcp.json e a chave é servers no lugar de mcpServers.

Testando sem cliente

O MCP Inspector abre uma interface web para chamar as ferramentas na mão:

npm run inspector

Exemplos de perguntas

Depois de configurado, é só conversar normalmente:

  • "Me dá um resumo do Flaviômetro de hoje."

  • "Quais senadores eleitos em 2026 postaram nos últimos dias mas não citaram o Flávio?"

  • "Ranking dos 10 deputados federais de SP que mais pediram voto para o Flávio."

  • "Como está o deputado Fulano de Tal? Mostra os últimos posts dele citando o Flávio."

  • "Compara os partidos: qual tem a maior proporção de políticos que já citaram o Flávio?"

  • "Quais vídeos mencionam o Flávio só na fala, e não na legenda? Traz os trechos."

  • "Quantos posts pedindo voto saíram por dia desde 08/10?"

  • "Quais prefeitos do Rio de Janeiro já pediram voto?"

  • "Qual é o e-mail da campanha do candidato Fulano de Tal?"

Variáveis de ambiente

Todas são opcionais.

Variável

Padrão

Descrição

FLAVIOMETRO_CACHE_TTL_SEGUNDOS

300

Por quanto tempo os dados ficam em cache na memória antes de novo download

FLAVIOMETRO_BASE_URL

https://flaviometro.com

Endereço base do site (útil para testes ou espelhos)

FLAVIOMETRO_VERSAO

—

Valor de ?v= usado no feed caso não seja possível lê-lo da página

FLAVIOMETRO_TSE_CACHE_HORAS

6

Por quanto tempo as bases do TSE e as consultas ao OpenCNPJ ficam em cache

FLAVIOMETRO_OPENCNPJ_URL

https://api.opencnpj.org

Endereço da API do OpenCNPJ

FLAVIOMETRO_PROXY

—

Proxy usado para acessar o site (veja Usando um proxy)

HTTPS_PROXY / HTTP_PROXY / NO_PROXY

—

Variáveis de proxy padrão do sistema, usadas se FLAVIOMETRO_PROXY não estiver definida

Exemplo no Claude Desktop:

{
  "mcpServers": {
    "flaviometro": {
      "command": "node",
      "args": ["/caminho/absoluto/flaviometro-mcp/dist/index.js"],
      "env": { "FLAVIOMETRO_CACHE_TTL_SEGUNDOS": "600" }
    }
  }
}

Usando um proxy

O proxy vale para todas as conexões do servidor: Flaviômetro, TSE e OpenCNPJ.

Se você está atrás de um proxy corporativo, quer sair por outro IP ou passar o tráfego por um túnel SSH, o servidor pode acessar o Flaviômetro por um proxy HTTP, HTTPS ou SOCKS5.

Ordem de prioridade

  1. FLAVIOMETRO_PROXY: se estiver definida, vale ela e só ela.

  2. HTTPS_PROXY / HTTP_PROXY (maiúsculas ou minúsculas): as variáveis padrão do sistema, respeitando NO_PROXY.

  3. Nenhuma das duas: conexão direta.

Para ignorar o proxy do sistema só neste servidor, use FLAVIOMETRO_PROXY=desligado.

Formatos aceitos

Tipo

Exemplo

HTTP

http://proxy.empresa.com.br:3128

HTTP com usuário e senha

http://usuario:senha@proxy.empresa.com.br:3128

HTTPS (conexão TLS até o proxy)

https://proxy.empresa.com.br:443

SOCKS5

socks5://127.0.0.1:1080

SOCKS5 com usuário e senha

socks5://usuario:senha@127.0.0.1:1080

Desativar

desligado

Caracteres especiais no usuário ou na senha (@, :, /, #...) precisam estar codificados em URL. Por exemplo, p@ss vira p%40ss.

Exemplos de configuração

Claude Desktop / Cursor (chave env):

{
  "mcpServers": {
    "flaviometro": {
      "command": "node",
      "args": ["/caminho/absoluto/flaviometro-mcp/dist/index.js"],
      "env": { "FLAVIOMETRO_PROXY": "http://usuario:senha@proxy.empresa.com.br:3128" }
    }
  }
}

OpenCode (chave environment):

"flaviometro": {
  "type": "local",
  "command": ["node", "/caminho/absoluto/flaviometro-mcp/dist/index.js"],
  "enabled": true,
  "environment": { "FLAVIOMETRO_PROXY": "socks5://127.0.0.1:1080" }
}

Claude Code:

claude mcp add flaviometro -e FLAVIOMETRO_PROXY=http://proxy.empresa.com.br:3128 \
  -- node /caminho/absoluto/flaviometro-mcp/dist/index.js

Túnel SSH como proxy SOCKS5: abra o túnel num terminal e aponte o servidor para ele.

ssh -D 1080 -N usuario@seu-servidor.com
# e use FLAVIOMETRO_PROXY=socks5://127.0.0.1:1080

Conferindo se o proxy está em uso

  • A ferramenta atualizar_dados mostra no campo proxy qual configuração está ativa. Usuário e senha aparecem mascarados (http://***@host:3128).

  • A mesma informação sai no log de inicialização do servidor (stderr), visível nos logs do seu cliente MCP.

  • Se o proxy estiver fora do ar ou mal configurado, as ferramentas respondem com o erro detalhado (por exemplo, Não consegui acessar https://flaviometro.com/ via proxy HTTP http://127.0.0.1:3128: connect ECONNREFUSED) em vez de travar.

O suporte a SOCKS5 vem do undici e ainda é marcado como experimental por lá. Por isso aparece um ExperimentalWarning no log. É só um aviso e não afeta o funcionamento. Proxies com autenticação NTLM/Kerberos não são suportados diretamente; nesses casos, use um intermediário local como o Px ou o CNTLM.

De onde vêm os dados

O servidor faz duas requisições, as mesmas que o navegador faz ao abrir o site:

  1. https://flaviometro.com/: a página inicial traz embutido o cadastro dos políticos monitorados (window.ELEITOS: nome, cargo, UF, partido, número, votos, redes) e a versão atual do site (window.VERSAO).

  2. https://flaviometro.com/dados/feed.json?v=<versão>: um JSON de alguns megabytes com todos os posts monitorados no período, já classificados pelo site.

O cadastro é lido como dado: o servidor recorta o objeto do HTML e o converte para JSON, sem executar nenhum JavaScript da página.

Os dados ficam em memória pelo tempo do cache (5 minutos por padrão). Chamadas seguidas não geram novos downloads. Se um download falhar e já houver dados em cache, o servidor responde com o cache anterior.

┌──────────────┐  stdio  ┌──────────────────┐  HTTPS  ┌──────────────────────┐
│ Cliente MCP  │ ──────▶ │  flaviometro-mcp │ ──────▶ │ flaviometro.com      │
│ (Claude etc.)│ ◀────── │  cache + análise │ ◀────── │  /  e  /dados/feed   │
└──────────────┘         └──────────────────┘         └──────────────────────┘

Contato da campanha (TSE + OpenCNPJ)

A ferramenta contato_campanha cruza três fontes públicas para chegar ao contato oficial da campanha de um candidato:

Flaviômetro            TSE (dados abertos)                    OpenCNPJ (Receita Federal)
sq do candidato ──▶ cadastro de candidatos 2026 ──▶ CNPJ ──▶ e-mail, telefone, endereço
                    + CNPJs de campanha 2026
  1. Cadastro de candidatos 2026 (consulta_cand_2026.zip, no Portal de Dados Abertos do TSE): pelo sq, o servidor encontra o nome completo, o cargo, a coligação e o resultado.

  2. CNPJs de campanha 2026 (CNPJ_campanha_2026.zip, no dataset de prestação de contas): todo candidato recebe um CNPJ de campanha com a razão social ELEICAO 2026 <NOME COMPLETO> <CARGO>. Como esse arquivo não traz o sq, o vínculo é feito pelo nome completo + cargo.

  3. OpenCNPJ: com o CNPJ, a API pública e gratuita do OpenCNPJ devolve o cadastro na Receita Federal, com o e-mail que a campanha informou.

Exemplo de resposta (resumida, com dados fictícios):

{
  "candidato": {
    "nome_completo": "FULANO DE TAL DA SILVA",
    "cargo": "DEPUTADO FEDERAL",
    "uf": "SP",
    "resultado": "ELEITO",
    "link_divulgacandcontas": "https://divulgacandcontas.tse.jus.br/divulga/#/candidato/SUDESTE/SP/20322002026/250000000000/2026/SP"
  },
  "campanha": {
    "cnpj": "00.000.000/0001-00",
    "vinculo": "exata",
    "situacao_cadastral": "Ativa",
    "email": "contato@exemplo.com.br",
    "endereco": "RUA EXEMPLO, 100, CENTRO, SAO PAULO/SP, CEP 01000-000"
  }
}

Como o vínculo é feito. O campo vinculo diz quão confiável é o casamento entre candidato e CNPJ:

  • exata: nome completo e cargo idênticos nos dois arquivos do TSE (é o caso de 988 dos 1.000 candidatos de 2026 monitorados pelo Flaviômetro).

  • aproximada (nome parecido, mesma UF): os dois arquivos do TSE grafam o nome de jeitos diferentes ("THYAGO" e "TYAGO", "SILVA COSTA" e "SILVA DA COSTA"). O servidor procura nomes parecidos no mesmo cargo e só aceita se a UF do CNPJ na Receita bater com a do candidato. A resposta mostra a razão social encontrada para você conferir.

O que não é coberto:

  • Prefeitos e senadores em mandato: não disputaram 2026, então não têm CNPJ de campanha nas bases de 2026.

  • Dados pessoais: o cadastro do TSE também traz CPF, título de eleitor e data de nascimento. O servidor descarta esses campos na leitura; eles nunca chegam ao modelo.

  • Página do DivulgaCandContas: o link é montado para você abrir no navegador, mas o servidor não lê essa página. O TSE bloqueia acesso automatizado a ela (HTTP 403), por isso o servidor usa os arquivos de dados abertos. O código de eleição do link (20322002026) é o do 1º turno; para candidatos do 2º turno a página pode ser outra.

NOTE

O e-mail e o telefone são os que a campanhainformou à Receita Federal ao registrar o CNPJ. Muitas vezes são do contador, do escritório de advocacia ou da equipe, não do candidato. Telefones vêm vazios com frequência.

Na primeira chamada, o servidor baixa cerca de 6 MB do TSE, o que leva alguns segundos. Depois disso, as bases ficam em cache por 6 horas (configurável).

Glossário dos códigos

Nível de citação de cada post (campo flavio no feed):

Valor

Significado

0

Não citou o Flávio

1

Citou o Flávio pelo nome, @, hashtag ou o 22 como voto

2

Pediu voto no Flávio ("vote 22", "dia 25 é Flávio"...)

Vídeos também contam pelo que é falado. Nesses casos o post vem marcado como citado_na_fala_do_video e traz o trecho_transcrito.

Cargos: gov governador(a) · sen senador(a) · fed deputado(a) federal · est deputado(a) estadual · pref prefeito(a)

Situação: eleito eleito(a) em 2026 · 2t disputa o 2º turno · mandato em mandato (não disputou em 2026)

Redes: ig Instagram · fb Facebook · x X/Twitter · th Threads · yt YouTube · tt TikTok · kw Kwai · tg Telegram

sq: código sequencial do candidato no TSE, usado como identificador único de cada político.

Limitações conhecidas

  • Depende da estrutura do site. Se o Flaviômetro mudar o HTML ou o formato do feed, o servidor quebra até ser ajustado.

  • A classificação é do site. Se um post foi classificado errado lá, ele aparece errado aqui. Este projeto não reclassifica nada.

  • Janela limitada. O feed só cobre um período recente (informado em feed_cobre_desde no resumo_geral), não o histórico completo.

  • Posts sem citação vêm resumidos. Para posts de nível 0, o feed só informa que existiram (data e rede), sem texto, link ou métricas.

  • Métricas incompletas. Visualizações, curtidas e compartilhamentos dependem do que cada rede expõe e podem vir null.

  • Números podem divergir do site. O site aplica filtros visuais próprios (e agrupa versões do mesmo conteúdo publicado em várias redes). Aqui cada post conta individualmente.

  • Vínculo com o CNPJ por nome. O arquivo de CNPJs do TSE não traz o código do candidato. Homônimos no mesmo cargo são desempatados pela UF, e vínculos aproximados vêm sinalizados.

  • Campo cobertura. O feed traz um par de datas por político cujo significado exato não é documentado. Ele aparece como cobertura_informada_pelo_feed e deve ser tratado como indicativo.

Desenvolvimento

npm run dev        # recompila a cada alteração
npm run build      # compila para dist/
npm run inspector  # abre o MCP Inspector apontando para dist/index.js

Estrutura:

src/
├── index.ts    # registro das ferramentas MCP e transporte stdio
├── fonte.ts    # download (com suporte a proxy), extração do cadastro e cache
├── analise.ts  # agregações, filtros, rótulos e formatação em pt-BR
└── tse.ts      # bases do TSE, vínculo candidato ↔ CNPJ e consulta ao OpenCNPJ

Logs vão para stderr, já que stdout é reservado ao protocolo MCP.

Uso responsável

  • O servidor é feito para uso pessoal e local. Ele baixa o feed no máximo uma vez a cada intervalo de cache e se identifica com um User-Agent próprio. Evite reduzir o cache a valores muito baixos.

  • O site marca suas páginas como noindex. Respeite a infraestrutura de quem mantém o Flaviômetro e não use este projeto para raspagem em massa nem para republicar os dados como se fossem seus.

  • Ao divulgar números obtidos por aqui, cite o Flaviômetro como fonte e deixe claro que a extração foi feita por uma ferramenta não oficial.

  • Os dados tratam de figuras públicas e posts públicos, mas use o bom senso: confira no post original antes de afirmar qualquer coisa sobre alguém.

  • Os contatos de campanha são dados públicos, mas continuam protegidos pela LGPD. Use para contato legítimo (imprensa, pesquisa, fiscalização) e não para envio em massa, spam ou montagem de listas. A ferramenta consulta um candidato por vez de propósito.

  • O OpenCNPJ é um projeto gratuito e sem fins lucrativos, feito para consultas pontuais. Não use este servidor para varrer CNPJs em lote.

Licença

MIT. Vale para o código deste repositório, não para os dados do Flaviômetro, do TSE ou do OpenCNPJ, que pertencem aos seus respectivos responsáveis.

Available Tools

9 tools
atualizar_dadosAtualizar dadosA

Força um novo download do feed do Flaviômetro, ignorando o cache local.

Inputs: no named parameters.

buscar_politicosBuscar políticosA

Lista políticos monitorados com filtros (nome, UF, cargo, partido, situação, município) e pelo comportamento em relação ao Flávio (pediu voto, citou, não citou, sem posts). Útil para perguntas como 'quais deputados federais do PL de SP não citaram o Flávio?'.

Inputs: uf, ate, nome, cargo, +7 more.

contato_campanhaContato da campanha (TSE + Receita)A

Busca o CNPJ de campanha de um candidato de 2026 nos dados abertos do TSE e consulta esse CNPJ no OpenCNPJ (base da Receita Federal) para obter o e-mail, telefone e endereço registrados pela campanha. Também traz coligação, resultado e o link da página do candidato no DivulgaCandContas. Funciona para quem disputou 2026 (governadores, senadores e deputados); não cobre prefeitos nem senadores em mandato. Consulta um político por vez.

Inputs: politico (required).

detalhes_politicoDetalhes de um políticoB

Ficha completa de um político: cargo, partido, votos, redes monitoradas, janela de cobertura, estatísticas por rede e os posts mais recentes em que citou o Flávio.

Inputs: politico (required), posts, incluir_posts_sem_citacao.

estatisticas_agrupadasEstatísticas agrupadasB

Agrega os números por estado, partido, cargo, rede social ou dia: quantos políticos citaram/pediram voto e quantos posts citando o Flávio houve em cada grupo.

Inputs: agrupar_por (required), uf, ate, nome, +5 more.

legendaLegenda dos códigosA

Explica os códigos usados nos dados (cargos, situações, redes, níveis de citação) e a metodologia.

Inputs: no named parameters.

listar_postsListar postsB

Lista posts captados pelo Flaviômetro com filtros por político, rede, nível de citação, período e texto. Por padrão traz só posts que citam o Flávio, do mais recente para o mais antigo.

Inputs: uf, ate, nome, rede, +10 more.

rankingRanking de políticosB

Ranking dos políticos que mais citaram o Flávio segundo uma métrica (posts citando, pedidos de voto, views ou interações dos posts citando). Aceita os mesmos filtros de buscar_politicos.

Inputs: uf, ate, nome, cargo, +6 more.

resumo_geralResumo geralA

Panorama do Flaviômetro: quantos políticos monitorados citaram o Flávio, quantos pediram voto, quantos ficaram em silêncio, totais de posts e quebra por cargo. Use como ponto de partida.

Inputs: ate, desde.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools target clearly different outputs: overview dashboard, filtered politician search, single-politician detail, post listing, ranking, grouped aggregation, and a campaign-contact lookup. The main soft overlaps are resumo_geral vs estatisticas_agrupadas (both aggregate numbers) and ranking vs buscar_politicos (ranking explicitly reuses the same filters), but descriptions make the distinction between a fixed panorama, a configurable aggregation, and an ordered list reasonably clear.

    Naming Consistency3/5

    All names are snake_case in Portuguese, which is consistent, but the conventions mix: verb_noun (buscar_politicos, atualizar_dados, listar_posts) alongside bare nouns (resumo_geral, ranking, legenda, contato_campanha, estatisticas_agrupadas) and noun_noun (detalhes_politico). Still readable and predictable enough to guess intent.

    Tool Count4/5

    Nine tools is a good size for a monitoring/analytics server, with each analysis angle (overview, search, detail, posts, ranking, grouped stats) earning its place. Minor ding for atualizar_dados being a maintenance-only tool and contato_campanha belonging to a distinct TSE/OpenCNPJ domain.

    Completeness4/5

    The read-only analytics surface is well covered: summary, filtered search, per-politician detail, post listing, ranking, grouped aggregation, code glossary, and a data refresh. Gaps are minor, such as no per-politician time-series/evolution tool and no direct post-detail or comparison operation, but agents can work around these with existing filters.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      Enables interaction with the Brazilian Chamber of Deputies Open Data API, providing access to information about legislators, legislative proposals, voting records, events, committees, and parliamentary activities through 57 typed and validated tools.
      63
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects AI agents to 28 Brazilian public APIs, providing over 200 tools to access data on economy, legislation, transparency, and the judiciary. It enables complex queries and cross-referencing of government datasets like IBGE, the Central Bank, and the National Congress through natural language.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to query Brazilian Senate data including senators, bills, voting records, committees, and plenary sessions through natural language.
      26 npm
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables lookup of Brazilian public data including companies (CNPJ), postal codes (CEP), banking, economy, geography, and more through 15 tools and 2 guided prompts, powered by BrasilAPI with no API key required.
      15
      MIT