Período eleitoral (até a diplomação, 18/12): o método recusa qualquer uso eleitoral, inclusive ligar o retrato de quem está no cargo ao resultado da eleição. Entenda as regras.

extrato.digital

Caminho MCP

Como usar um servidor MCP (Model Context Protocol) como atalho opcional para as fontes oficiais — conveniência, não requisito: o método nunca depende dele, e a API oficial sempre vence.

Para agentes: versão .md desta página · índice em /llms.txt

O método deste site foi desenhado para funcionar sem instalar nada: a sua IA lê o playbook, monta a URL da fonte oficial e consulta a Câmara, o Senado ou a CLDF diretamente. Esta página é para quem já usa — ou quer usar — um servidor MCP como atalho. É uma conveniência para quem tem esse ambiente configurado; não é requisito e não muda nenhuma regra do método.

O que é, em uma frase

MCP (Model Context Protocol) é um padrão aberto para um assistente de IA usar ferramentas externas. Um servidor MCP de dados públicos expõe as APIs oficiais (Câmara, Senado, portais de transparência) como ferramentas prontas, poupando a IA de montar cada URL à mão. Só isso: ele troca “a IA monta a URL” por “a IA chama uma ferramenta que monta a URL”. A fonte continua sendo o órgão público.

Por que isto combina com o método (e por que não é obrigatório)

  • O método é AI-first e agnóstico. Qualquer caminho pelo qual a sua IA chegue à fonte oficial é válido. O MCP é um deles.
  • O caminho padrão já funciona. Os playbooks trazem as URLs canônicas e foram validados sem nenhum servidor intermediário — é o que o selo de saúde das fontes verifica toda semana.
  • Não conflita com “zero requests externos”. Essa regra é sobre este site (sem CDN, fontes externas ou analytics no HTML). A sua IA consultando as fontes oficiais — por URL ou por ferramenta MCP — é o produto funcionando.

Regra de ouro: local, sim; hospedado por terceiro, com ressalva

  • Prefira um servidor MCP que rode na sua máquina (aberto, auditável, sem chave), chamando as APIs oficiais direto: a requisição sai do seu computador para os domínios .leg.br / .gov.br sem intermediário na rede. Isso preserva a fonte primária.
  • Evite servidores hospedados por terceiros. Eles colocam alguém entre você e o órgão público e podem servir cache próprio — um dado defasado apresentado como se fosse ao vivo é exatamente o que um extrato de mandato em exercício não pode ter.
  • Nunca cole uma chave sua num servidor de terceiro. A única fonte do método que pede token (Portal da Transparência federal, registro gratuito) é opcional, e a chave é sua e fica na sua máquina. Veja funciona com qualquer IA.
  • O mesmo raciocínio vale para a conversa. Um servidor MCP local tira o intermediário da requisição; o que a sua IA guarda da conversa continua sendo regido pelo fornecedor dela — veja o que a conversa guarda.

As regras não mudam por causa da ferramenta

  1. Fonte primária manda. Cite o dado como vindo da Câmara / do Senado / da CLDF e o endpoint oficial — nunca “segundo o servidor MCP”. O MCP é encanamento; a fonte é o órgão.
  2. Fallback obrigatório. Se a ferramenta falhar, devolver dado antigo ou divergir do playbook, a IA vai direto à API oficial (URLs nos playbooks) e confere. Em divergência, a API oficial vence.
  3. Verificação ao vivo. Servidores com cache podem estar velhos; toda afirmação factual se confirma contra a fonte no momento da consulta — com a data registrada, como pede o guia de qualidade de dados.
  4. Cadeia de suprimento. Instalar um servidor MCP é executar código de terceiro na sua máquina. Só servidores de código aberto, com licença clara e histórico público. Na dúvida, não instale: o caminho padrão funciona.
  5. Escopo do método. Alguns servidores expõem ferramentas de dados eleitorais (TSE). O método não as usa nem as estimula: escopo restrito ao mandato em exercício, nada sobre candidatos ou eleições — a mesma regra de sempre.

O que dizer à sua IA

Se você já tem um servidor MCP de dados públicos brasileiros configurado, basta acrescentar ao prompt copiável da página inicial: “Você pode usar as ferramentas MCP disponíveis para consultar as fontes oficiais, mas cite sempre o endpoint oficial como fonte, e, se a ferramenta falhar ou divergir do playbook, consulte a API oficial diretamente.” Nada mais muda.

O que este site não faz

Não hospeda nem recomenda um servidor específico — servidores de terceiros mudam, saem do ar e ficam desatualizados, e amarrar o método a um deles contrariaria a ideia de mapa de ferramentas públicas. Um servidor MCP próprio, publicado por este projeto, está no backlog como projeto à parte (este site é estático por desenho e não roda processo algum).


Riscos honestos deste caminho: intermediário não oficial (erro de mapeamento), cache/defasagem, disponibilidade, credencial exposta e cadeia de suprimento — todos mitigados pela regra “local + aberto + a API oficial vence”. Veja também por que assim e fontes de dados.