Tálamo
    esenpt
    Tálamo MCPv1.3

    academy_​complete_​lesson

    Prepara a conclusão de uma aula e exige aprovação no Tálamo.

    Academia
    Escrita fechada
    Versão do contrato 1.0.0

    Permissões e segurança

    Procedência
    academy
    Requer confirmação
    Sim
    openWorld
    false

    Esquema de entrada

    json
    {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "lesson_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
    },
    "confirmation_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
    }
  },
  "required": [
    "lesson_id"
  ],
  "additionalProperties": false
}

    Esquema de saída

    json
    {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "confirmation_required": {
      "type": "boolean"
    },
    "confirmation_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
    },
    "confirmation_url": {
      "type": "string",
      "format": "uri"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "additionalProperties": {}
}

    Exemplo

    json
    {
  "title": "Prepare lesson completion",
  "input": {
    "lesson_id": "00000000-0000-4000-8000-000000000002"
  },
  "output": {
    "confirmation_required": true,
    "confirmation_id": "00000000-0000-4000-8000-000000000003",
    "confirmation_url": "https://talamo.app/mcp/confirm/00000000-0000-4000-8000-000000000003",
    "expires_at": "2026-08-06T12:10:00.000Z"
  }
}

    Limites

    • The lesson must be published.
    • One-time confirmation expires after 10 minutes.

    Erros estáveis

    CodeDescription
    UNAUTHORIZEDThe OAuth token is missing, expired, revoked, or invalid for this resource.
    VALIDATION_ERRORThe arguments do not match the published input schema.
    TOOL_ERRORThe operation could not be completed without exposing internal details.
    CONFIRMATION_REQUIREDOpen the returned URL and approve the exact action.
    CONFIRMATION_INVALIDThe approval is expired, denied, already used, or does not match the payload.