Para agentes
Este site foi feito para ser lido por assistentes de IA e por pessoas. Tudo abaixo é público e não exige login.
Conectar
Um servidor MCP remoto via streamable HTTP:
https://api.edmarbarros.com/mcp
A página inicial tem a configuração para copiar e colar nos clientes mais comuns.
Ferramentas
Todas as ferramentas são somente leitura, exceto uma, que só rascunha.
site_help- O que dá para perguntar, com exemplos.site_get_profile- Quem eu sou, em uma chamada.site_get_cv- O CV completo, com filtros opcionais.site_list_skills / site_get_skill- Habilidades e as evidências de cada uma.site_list_projects / site_get_project- Projetos detalhados.site_list_posts / site_get_post- Posts do blog, em markdown.site_search- Busca textual ranqueada em tudo isso.site_draft_message- Rascunha uma mensagem para mim. Uma pessoa revisa e envia na página de contato.
Decisões de design
- Sem estado: cada requisição cria um servidor novo e responde com JSON simples. Sem sessões, sem streaming.
- Somente leitura: as ferramentas leem uma exportação estática em JSON deste site. Nada que um assistente faça altera o site.
- Uma pessoa continua no controle: site_draft_message devolve um link. A pessoa lê o rascunho, passa pela verificação do Turnstile e envia.
- O mesmo conteúdo do site, em português e inglês, para o assistente responder com as minhas palavras e não com o que um modelo lembra.
Sem MCP
- Índice da exportação em JSON: /api/index.json
- Resumo em texto para LLMs: /llms.txt
Como a busca é testada
A busca é testada sem nenhum modelo. Um conjunto de perguntas reais roda contra o conteúdo exato que o servidor entrega, e cada uma precisa colocar o resultado certo entre os 3 primeiros. Perguntas sobre tecnologias que eu não usei devem retornar nada.
O teste também guarda uma lista de falhas conhecidas e quebra quando uma é corrigida, para a nota ser removida. Hoje não há nenhuma.