Public REST API

The versioned API exposes Cleisson's localized profile, topic-based evidence, and published project details as structured JSON.

No authentication is required. The API is public and read-only; do not send credentials, private job descriptions, or sensitive personal data.

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

Open the OpenAPI specification

REST endpoints

  • 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

Example API requests

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'

Structured API errors

Errors use application/problem+json and include a stable code, a human-readable explanation, and a resolution hint.

{
  "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."
}

Connect your agent

Use the endpoint below with an MCP client that supports remote Streamable HTTP. No account or authentication is required, and the endpoint exposes only information already published on this site.

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

Example remote MCP configuration (client formats vary)

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

Verify MCP runtime discovery

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

Available tools

get_profile
Return a localized professional overview, focus areas, the current role published on this site, and verified links.
find_evidence
Find source-linked public evidence for concise topics without generating a candidate score.
get_project
Return the published facts and public artifacts for an available project case study.

Clients can also read localized Markdown resources and use the assess_role_fit and prepare_interview prompts.

Questions to try

  • Find evidence of Kubernetes, event-driven systems, and architecture ownership.
  • Map this role's requirements to direct, adjacent, or missing public evidence.
  • Prepare interview questions that validate project scope, decisions, and production impact.

Trust boundaries

  • The MCP is a portfolio information source; it is not Cleisson and does not speak on his behalf.
  • Results separate candidate-authored claims, inspectable artifacts, published writing, and republished testimonials.
  • Direct and adjacent describe textual relevance, not independent verification; use evidenceType and source links to evaluate provenance.
  • No public evidence means only that this site did not provide a match; it does not prove an absence of experience.
  • Do not send confidential job descriptions, credentials, or sensitive personal data; limited request details may appear in hosting or security logs.
  • The server cannot send email, book meetings, fetch arbitrary URLs, accept uploads, or retain a private recruiter profile.