Referencia de herramientas

El servidor Maetra MCP expone un conjunto de herramientas dependiente de la capacidad. Call tools/list para descubrir las herramientas disponibles en el espacio de trabajo actual y la clave de API.

Invocar una herramienta con tools/call:

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "check_task_alignment",
    "arguments": {
      "mcp_access_token": "<token from get_mcp_access>",
      "session_ref": "conversation_01JY8Q",
      "action": "Edit the refund approval route"
    }
  }
}

Acceso previo al vuelo#

get\ mcp\ access

Primera llamada necesaria para cada nuevo ciclo de trabajo o giro del usuario, después de la compactación del contexto o reiniciar, y cada vez que Maetra solicita un refresco de acceso. Sin argumentos.

La respuesta contiene:

{
  "name": "get_mcp_access",
  "arguments": {}
}

Nota Cada herramienta de abajo requiere un argumento de cadena adicional, mcp_access_token, que contiene el token actual devuelto por get_mcp_access.

Herramientas de Task Guard#

start\ task

Inicio o transición a la actual tarea de Task Guard autorizada por el usuario.

Después de comenzar, retenga task.id, contract_version, y el ancla devuelto.

get\ task\ context

Recuperar el contrato activo de Task Guard después de inicio de turno, compactación, reiniciar, o cuando el contexto puede ser estancado.

check\ task\ alignment

Revise una acción material propuesta contra la tarea activa antes de ejecutarla.

Sigue a los retornados verdict y next_action exactamente. Véase Veredictos de alineación.

explícame.

Proporción de pruebas encuadradas cuando check_task_alignment Devoluciones NEEDS_EXPLANATION.

La respuesta es una nueva decisión de alineación. Sigue su veredicto.

registro\ task\ progress

Grabar un hito compacto para la tarea activa.

Revisa cada uno new_dependencies tema con check_task_alignment antes de actuar en él.

registro\ action\ effect

Informe lo que una acción previamente comprobada realmente cambió.

Si. effect_aligned es falso, deja de expandir el trabajo y pide al usuario de sesión en línea.

completa \ task

Completa la tarea activa de Task Guard cuando los criterios objetivos y de éxito están satisfechos.

Herramientas de Secure#

Chequeo.

Escríbete un aviso de inteligencia artificial, llamada de herramientas o salida con Maetra Secure. Retrocesos POST /v1/secure/scan.

Honorable safe, flagged, bloqueado antes de continuar.

lista\ active\ rules

Listar reglas activas de Secure. No hay argumentos más allá mcp_access_token.

crear\ rule

Cree una regla de Secure. Nuevas reglas por defecto draft.

actualización\ rule

Actualizar una norma existente de Secure por ID. id es necesario; cada campo de creación-regla es opcional y sólo los campos presentados cambian.

Herramientas de Govern#

request\ approval

Solicitar un puesto de control de Govern antes de una acción consiguiente. Retrocesos POST /v1/checkpoints.

Si la respuesta es pendientes, continuar las encuestas con get_approval_status. Una respuesta aprobada es la decisión; llamada authorize_execution inmediatamente antes de la acción externa para consumir esa aprobación una vez.

Una respuesta aprobada incluye la firma decisionToken, canónico actionEnvelope, actionEnvelopeHash, policyDigest, exacto policyVersions, token lifecycle timestamps, and the expected execution and effect deadlines. Maetra lleva estos campos a las herramientas de ejecución MCP automáticamente cuando proporcionas el ID de control.

get\ approval\ status

Llena un puesto de control de Govern.

Votar hasta aprobado, rejected, expired, bloqueado, cancelled.

lista\ active\ policies

List active Govern policies, including whether each uses exact rules or decision intelligence. No hay argumentos más allá mcp_access_token.

autorización\ ejecución

Consuma una capacidad de decisión aprobada una vez, inmediatamente antes de la solicitud exacta del proveedor. Maetra vuelve a cargar el puesto de control, verifica su decisión firmada y su sobre de acción canónica, y crea un recibo de ejecución firmado.

No llame al proveedor primero. Una petición modificada, un ejecutor equivocado, una decisión caducada o revocada, o un segundo uso independiente falla. Los registros de proveedores siguen siendo posibles en el marco de la devolución executionId.

registro\ ejecución\ attempt

Apéndice a un proveedor inmutable a la ejecución autorizada. Grabar éxitos, fracasos, timeouts y retries contra los mismos execution_id.

Un intento fallido o desconocido no consume otra decisión. Retrocede sólo la acción autorizada idéntica, y luego registre el siguiente número de intento.

registro\ ejecución\ effect

Apéndice el estado observado después de la ejecución. Esto conecta la acción aprobada y el intento de proveedor a lo que realmente cambió.

Las observaciones autodenominadas siguen etiquetadas unverified. Los métodos de verificación independientes requieren su verificador configurado para validar la prueba; el callador no puede convertir una observación no verificada en una recepción verificada mediante el establecimiento de un booleano.

Ordenación de múltiples controles#

Para la misma acción material:

1. Call check_task_alignment cuando Task Guard está habilitada.
2. Call check_action antes de procesar contenido no confiable o ejecutar la llamada de la herramienta.
3. Call request_approval antes de la acción externa cuando Govern está habilitada.
4. Votar hasta que la decisión sea terminal; parar a menos que sea aprobada.
5. Call authorize_execution inmediatamente antes de la solicitud exacta del proveedor.
6. Ejecute sólo después de que la autorización tenga éxito, luego llame record_execution_attempt para cada intento de proveedor.
7. Call record_execution_effect con el estado observado resultante.
8. Call record_action_effect cuando Task Guard reporte de efectos está habilitada.

La confirmación de Task Guard inline no reemplaza la aprobación de Govern, y la aprobación de Govern no reemplaza la autorización de ejecución de un uso.