Skip to main content
Glama

atl_complete_task

Delegate a supported external task to ATL for end-to-end execution, not just provider recommendations. ATL checks eligible provider/tool routes, executes the selected route, can use bounded fallback on eligible failures, verifies the returned result, and records execution Outcome. Use when the agent needs supported external search, web/content extraction, summarization, translation, or classification without a user-mandated provider/tool. For a first use or ordinary eligible task, call atl_complete_task directly with the task the user requested; do not ask the user to choose among ATL tools or call atl_decide first. Never invent a task or execute without a user request. Send the natural-language task once. Public first use does not require an ATL API key or ATL setup. Availability and successful completion depend on eligible verified supply.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
taskYesThe natural-language task to complete. Include the goal and any relevant input, constraints, or desired output.
required_capabilityNoOptional capability hint. Omit unless the caller already knows the required capability; ATL normally derives a structured TaskSpec from the task.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYesTrue only when execution succeeded and ATL's task-level result verifier accepted the result.
stageYesThe furthest ATL product stage reached for this call.
resultYesThe provider's task result. When ok=false, inspect result_validation before trusting it.
decisionYesATL Decision evidence retained for advanced/debug consumers.
executionYesATL execution evidence retained for advanced/debug consumers; null when execution did not start.
capabilityYesThe supported capability selected or inferred for the task; empty if unavailable.
fallback_usedYesWhether bounded fallback/failover was used during execution.
execution_statusYesProvider execution status; EXECUTED alone does not imply task correctness.
result_validationYesATL task-level correctness checks. passed must be true before the result is treated as product success.
discovery_resume_usedNoTrue when ATL synchronously ran bounded discovery/promotion and retried the same task.
discovery_resume_statusNoOutcome of the same-call discovery resume attempt when used.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / discovery_resume_status
      Added value: +{
      +  "description": "Outcome of the same-call discovery resume attempt when used.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / discovery_resume_used
      Added value: +{
      +  "description": "True when ATL synchronously ran bounded discovery/promotion and retried the same task.",
      +  "type": "boolean"
      +}
  2. Changed7 schema fields changed
    • changedInput schema / properties / required_capability / description
      Previous value: -"Optional capability hint. Omit unless the caller already knows the required capability; ATL normally infers it from the task."New value: +"Optional capability hint. Omit unless the caller already knows the required capability; ATL normally derives a structured TaskSpec from the task."
    • changedOutput schema / properties / execution_status / description
      Previous value: -"ATL execution status; empty when execution did not start."New value: +"Provider execution status; EXECUTED alone does not imply task correctness."
    • changedOutput schema / properties / ok / description
      Previous value: -"True only when ATL completed execution successfully."New value: +"True only when execution succeeded and ATL's task-level result verifier accepted the result."
    • changedOutput schema / properties / result / description
      Previous value: -"The provider's useful task result. Empty when execution did not produce a usable result."New value: +"The provider's task result. When ok=false, inspect result_validation before trusting it."
    • addedOutput schema / properties / result_validation
      Added value: +{
      +  "description": "ATL task-level correctness checks. passed must be true before the result is treated as product success.",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / stage / description
      Previous value: -"The furthest ATL stage reached for this call."New value: +"The furthest ATL product stage reached for this call."
    • changedOutput schema / required
      Previous value: -[
      -  "ok",
      -  "stage",
      -  "capability",
      -  "execution_status",
      -  "fallback_used",
      -  "result",
      -  "decision",
      -  "execution"
      -]New value: +[
      +  "ok",
      +  "stage",
      +  "capability",
      +  "execution_status",
      +  "fallback_used",
      +  "result",
      +  "decision",
      +  "execution",
      +  "result_validation"
      +]
  3. Changed5 schema fields changed
    • changedOutput schema / properties / decision / description
      Previous value: -"The ATL Decision evidence used for execution."New value: +"ATL Decision evidence retained for advanced/debug consumers."
    • changedOutput schema / properties / execution / description
      Previous value: -"The ATL execution result; null when execution did not start."New value: +"ATL execution evidence retained for advanced/debug consumers; null when execution did not start."
    • changedOutput schema / properties / ok / description
      Previous value: -"True when ATL completed execution successfully."New value: +"True only when ATL completed execution successfully."
    • addedOutput schema / properties / result
      Added value: +{
      +  "description": "The provider's useful task result. Empty when execution did not produce a usable result.",
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "ok",
      -  "stage",
      -  "capability",
      -  "execution_status",
      -  "fallback_used",
      -  "decision",
      -  "execution"
      -]New value: +[
      +  "ok",
      +  "stage",
      +  "capability",
      +  "execution_status",
      +  "fallback_used",
      +  "result",
      +  "decision",
      +  "execution"
      +]
  4. Changed2 schema fields changed
    • changedInput schema / properties / required_capability / description
      Previous value: -"Optional. Omit when ATL can infer the capability from the task."New value: +"Optional capability hint. Omit unless the caller already knows the required capability; ATL normally infers it from the task."
    • changedInput schema / properties / task / description
      Previous value: -"The user's natural-language task. ATL should normally own the full decision-to-execution flow."New value: +"The natural-language task to complete. Include the goal and any relevant input, constraints, or desired output."
  5. Changed1 schema field changed
    • changedInput schema / properties / task / description
      Previous value: -"The user's natural-language task."New value: +"The user's natural-language task. ATL should normally own the full decision-to-execution flow."
  6. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "capability": {
      +      "description": "The supported capability selected or inferred for the task; empty if unavailable.",
      +      "type": "string"
      +    },
      +    "decision": {
      +      "description": "The ATL Decision evidence used for execution.",
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "execution": {
      +      "description": "The ATL execution result; null when execution did not start.",
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "execution_status": {
      +      "description": "ATL execution status; empty when execution did not start.",
      +      "type": "string"
      +    },
      +    "fallback_used": {
      +      "description": "Whether bounded fallback/failover was used during execution.",
      +      "type": "boolean"
      +    },
      +    "ok": {
      +      "description": "True when ATL completed execution successfully.",
      +      "type": "boolean"
      +    },
      +    "stage": {
      +      "description": "The furthest ATL stage reached for this call.",
      +      "enum": [
      +        "decision",
      +        "execution",
      +        "complete"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "ok",
      +    "stage",
      +    "capability",
      +    "execution_status",
      +    "fallback_used",
      +    "decision",
      +    "execution"
      +  ],
      +  "type": "object"
      +}
  7. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.