API REST pública

A API versionada oferece o perfil localizado de Cleisson, evidências por tópico e detalhes de projetos publicados em JSON estruturado.

Nenhuma autenticação é necessária. A API é pública e somente leitura; não envie credenciais, descrições confidenciais de vagas ou dados pessoais sensíveis.

https://www.cleisson.com/openapi.json

Abrir a especificação OpenAPI

Endpoints REST

  • GET /api/v1/profile?locale=en-US
  • GET /api/v1/evidence?topics=Kubernetes&topics=AWS&locale=en-US&limitPerTopic=5
  • GET /api/v1/projects/{slug}?locale=en-US

Exemplos de requisições à API

curl 'https://www.cleisson.com/api/v1/profile?locale=en-US'
curl --get 'https://www.cleisson.com/api/v1/evidence' --data-urlencode 'topics=Kubernetes' --data-urlencode 'topics=AWS' --data-urlencode 'locale=en-US'

Erros estruturados da API

Os erros usam application/problem+json e incluem um código estável, uma explicação legível e uma orientação para resolver o problema.

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "The locale query parameter is not supported.",
  "instance": "/api/v1/profile",
  "code": "invalid_locale",
  "message": "The locale query parameter is not supported.",
  "resolution": "Use one of: en-US, pt-BR, es-ES."
}

Conecte seu agente

Use o endpoint abaixo em um cliente MCP compatível com Streamable HTTP remoto. Nenhuma conta ou autenticação é necessária, e o endpoint expõe apenas informações já publicadas neste site.

https://www.cleisson.com/api/mcp

Exemplo de configuração MCP remota (o formato varia por cliente)

{
  "mcpServers": {
    "cleisson-professional-evidence": {
      "url": "https://www.cleisson.com/api/mcp"
    }
  }
}

Verificar a descoberta MCP em tempo de execução

curl 'https://www.cleisson.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: server/discover' \
  --data '{"jsonrpc":"2.0","id":"discover-1","method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"audit","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'

Ferramentas disponíveis

get_profile
Retorna um resumo profissional localizado, áreas de foco, a função atual publicada neste site e links verificados.
find_evidence
Encontra evidências públicas ligadas às fontes para tópicos concisos, sem gerar uma nota de candidato.
get_project
Retorna os fatos publicados e artefatos públicos de um estudo de caso disponível.

Os clientes também podem ler recursos Markdown localizados e usar os prompts assess_role_fit e prepare_interview.

Perguntas para testar

  • Encontre evidências de Kubernetes, sistemas orientados a eventos e responsabilidade por arquitetura.
  • Mapeie os requisitos desta vaga para evidências diretas, adjacentes ou públicas ausentes.
  • Prepare perguntas de entrevista que validem escopo, decisões e impacto em produção.

Limites de confiança

  • O MCP é uma fonte de informações do portfólio; ele não é Cleisson e não fala em nome dele.
  • Os resultados diferenciam declarações do candidato, artefatos verificáveis, textos publicados e recomendações republicadas.
  • Direta e adjacente descrevem relevância textual, não verificação independente; use evidenceType e os links de fonte para avaliar a procedência.
  • Nenhuma evidência pública significa apenas que este site não encontrou correspondência; isso não prova ausência de experiência.
  • Não envie descrições confidenciais de vagas, credenciais ou dados pessoais sensíveis; detalhes limitados da requisição podem aparecer em logs de hospedagem ou segurança.
  • O servidor não envia e-mails, agenda reuniões, consulta URLs arbitrárias, recebe uploads nem mantém um perfil privado do recrutador.