All tools
ToolWrite

Report MCP workflow progress

report_mcp_workflow_progress

You need the user's accessible workspace map or a compact context pack.

When to use it

You need the user's accessible workspace map or a compact context pack.

Typical workflow

Orient first, then choose the smallest task-specific tool.

What it returns

Workspace availability, recent objects, tool routing, or query-focused context.

Avoid using it when

You already have the exact source, draft, post, artifact, or portfolio id.

Advanced input contract

Agent hosts use this JSON Schema to validate the exact input shape.

View JSON Schema
{
  "type": "object",
  "properties": {
    "workflowId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "steps": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "complete",
              "failed",
              "skipped"
            ],
            "default": "pending"
          }
        },
        "required": [
          "label"
        ],
        "additionalProperties": false
      }
    },
    "currentStep": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "complete",
        "failed",
        "cancelled"
      ]
    },
    "message": {
      "type": "string",
      "maxLength": 500
    },
    "contextRunId": {
      "type": "string",
      "format": "uuid",
      "description": "Active Prism context run for this workflow. This direct field is preferred for simple reporters; contextRun remains available for token metadata."
    },
    "outcome": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "resolved",
            "partial",
            "no_result",
            "corrected",
            "failed",
            "abandoned"
          ]
        },
        "summary": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        },
        "nextAction": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "summary"
      ],
      "additionalProperties": false
    },
    "contextRun": {
      "type": "object",
      "properties": {
        "contextRunId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "profile": {
          "type": "string",
          "enum": [
            "essentials",
            "standard",
            "deep"
          ]
        },
        "tokenBudget": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100000
        },
        "tokenUsage": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100000
        }
      },
      "required": [
        "contextRunId"
      ],
      "additionalProperties": false
    },
    "evidence": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          },
          "quote": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "location": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "id",
          "type"
        ],
        "additionalProperties": false
      }
    },
    "usedEvidence": {
      "type": "array",
      "maxItems": 20,
      "description": "Canonical evidence used by the workflow. Alias of evidence for the explicit reporting contract.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          },
          "quote": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "location": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "id",
          "type"
        ],
        "additionalProperties": false
      }
    },
    "resources": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          }
        },
        "required": [
          "id",
          "type"
        ],
        "additionalProperties": false
      }
    },
    "producedResources": {
      "type": "array",
      "maxItems": 20,
      "description": "Canonical resources produced by the workflow. Alias of resources for the explicit reporting contract.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          }
        },
        "required": [
          "id",
          "type"
        ],
        "additionalProperties": false
      }
    },
    "correction": {
      "type": "object",
      "properties": {
        "memoryId": {
          "type": "string",
          "format": "uuid"
        },
        "action": {
          "type": "string",
          "enum": [
            "remembered",
            "corrected",
            "forgotten"
          ]
        },
        "reason": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    "correctionDetails": {
      "type": "object",
      "description": "Memory correction performed by the workflow. Alias of correction for the explicit reporting contract.",
      "properties": {
        "memoryId": {
          "type": "string",
          "format": "uuid"
        },
        "action": {
          "type": "string",
          "enum": [
            "remembered",
            "corrected",
            "forgotten"
          ]
        },
        "reason": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "workflowId",
    "label",
    "steps",
    "currentStep",
    "status"
  ],
  "additionalProperties": false
}

Useful next tools