API REST pública

La API versionada ofrece el perfil localizado de Cleisson, evidencia por tema y detalles de proyectos publicados como JSON estructurado.

No se requiere autenticación. La API es pública y de solo lectura; no envíes credenciales, descripciones confidenciales de puestos ni datos personales sensibles.

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

Abrir la especificación 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

Ejemplos de solicitudes a la 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'

Errores estructurados de la API

Los errores usan application/problem+json e incluyen un código estable, una explicación comprensible y una sugerencia para resolver el 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."
}

Conecta tu agente

Usa el endpoint siguiente con un cliente MCP compatible con Streamable HTTP remoto. No se requiere cuenta ni autenticación, y el endpoint solo expone información ya publicada en este sitio.

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

Ejemplo de configuración MCP remota (el formato varía según el cliente)

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

Verificar el descubrimiento MCP en tiempo de ejecución

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":{}}}}'

Herramientas disponibles

get_profile
Devuelve un resumen profesional localizado, áreas de enfoque, el rol actual publicado en este sitio y enlaces verificados.
find_evidence
Encuentra evidencia pública vinculada a fuentes para temas concisos sin generar una puntuación de candidato.
get_project
Devuelve los hechos publicados y artefactos públicos de un caso de estudio disponible.

Los clientes también pueden leer recursos Markdown localizados y usar los prompts assess_role_fit y prepare_interview.

Preguntas para probar

  • Encuentra evidencia de Kubernetes, sistemas basados en eventos y responsabilidad de arquitectura.
  • Mapea los requisitos de este puesto con evidencia directa, adyacente o pública ausente.
  • Prepara preguntas de entrevista que validen alcance, decisiones e impacto en producción.

Límites de confianza

  • El MCP es una fuente de información del portafolio; no es Cleisson ni habla en su nombre.
  • Los resultados diferencian declaraciones del candidato, artefactos inspeccionables, textos publicados y testimonios republicados.
  • Directa y adyacente describen relevancia textual, no verificación independiente; usa evidenceType y los enlaces de origen para evaluar la procedencia.
  • Sin evidencia pública solo significa que este sitio no encontró una coincidencia; no demuestra ausencia de experiencia.
  • No envíes descripciones confidenciales de puestos, credenciales ni datos personales sensibles; detalles limitados de la solicitud pueden aparecer en registros de alojamiento o seguridad.
  • El servidor no envía correos, reserva reuniones, consulta URLs arbitrarias, acepta archivos ni conserva un perfil privado del reclutador.