MCP Tools
Content

get_generation_status

Check the status of an async content generation. Call this after create_content (with blueprint_uuid), 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_content (with blueprint_uuid)."
    }
  }
}

Output Schema

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

Instructions

Check the status of an async content generation. Call this after create_content (with blueprint_uuid), which returns a generation_id.

Typical workflow:

  1. Call create_content with a blueprint_uuid → 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 "completed", wait and retry
  5. When complete, the response includes the content summary with its ID
  6. Use get_content with the content_id to retrieve the full content
Scroll to Top