MCP Tools
Deliverables

get_generation_status

Check the status of an async deliverable generation. Call this after create_deliverable_from_blueprint, which returns a generation_id.

Parameters

NameTypeRequiredDefaultDescription
generation_idstringYesThe generation ID returned by create_deliverable_from_blueprint

Input Schema

{
  "type": "object",
  "required": [
    "generation_id"
  ],
  "properties": {
    "generation_id": {
      "type": "string",
      "description": "The generation ID returned by create_deliverable_from_blueprint"
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Generation status (e.g. pending, gathering context, processing, completed, failed)."
    },
    "deliverable": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Document name."
        },
        "link_url": {
          "type": "string",
          "format": "uri",
          "description": "Direct URL to view/open the deliverable."
        },
        "blueprint_id": {
          "type": "integer",
          "description": "Blueprint used to generate this deliverable."
        },
        "deliverable_id": {
          "type": "string",
          "format": "uuid",
          "description": "Document ID. Pass to get_deliverable to retrieve full content."
        }
      },
      "description": "Deliverable summary (present when status is completed). Use get_deliverable with deliverable_id to get full content."
    },
    "generation_id": {
      "type": "string",
      "description": "The generation ID being checked."
    }
  }
}

Instructions

Check the status of an async deliverable generation. Call this after create_deliverable_from_blueprint, which returns a generation_id.

Typical workflow:

  1. Call create_deliverable_from_blueprint → get generation_id
  2. Wait 2-4 minutes (generation takes time)
  3. Call this tool with the generation_id to check progress
  4. If status is not complete, wait and retry
  5. When complete, the response includes the deliverable summary with its ID
  6. Use get_deliverable with the deliverable_id to retrieve the full content
Scroll to Top