MCP Tools
Content

get_generation_status

Poll the status of an async generation by generation_id. Two tools produce a generation_id you can check here: create_content (with blueprint_uuid) or ask_content_assistant.

Parameters

NameTypeRequiredDefaultDescription
generation_idstringYes—The generation ID returned by create_deliverable_from_blueprint

Input Schema

{
  "type": "object",
  "required": [
    "generation_id"
  ],
  "properties": {
    "generation_id": {
      "type": "string",
      "format": "uuid",
      "description": "The generation ID returned by create_content (with blueprint_uuid) or ask_content_assistant."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Status of this run. Blueprint flow terminates at completed; Content Assistant flow terminates at complete; failed on error. Intermediate: pending, processing, streaming."
    },
    "content": {
      "type": [
        "object",
        "null"
      ],
      "description": "null until the run completes. Shape depends on flow_type."
    },
    "flow_type": {
      "type": "string",
      "description": "ai_assistant for ask_content_assistant runs, otherwise a blueprint/content generation."
    },
    "generation_id": {
      "type": "string",
      "format": "uuid",
      "description": "The generation ID being checked."
    }
  }
}

Instructions

Poll the status of an async generation by generation_id. Two tools produce a generation_id you can check here:

  • create_content with a blueprint_uuid (blueprint document generation)
  • ask_content_assistant (the in-document Content Assistant)

The response always includes status, generation_id, and flow_type. content is null until the run finishes.

Parameters

Parameter Type Required Description
generation_id string (uuid) Yes The generation ID returned by create_content (with blueprint_uuid) or ask_content_assistant

Output

Field Type Description
generation_id string (uuid) The generation ID being checked
status string Status of this run. Blueprint flow terminates at completed; Content Assistant flow terminates at complete; failed on error. Intermediate: pending, processing, streaming
flow_type string ai_assistant for ask_content_assistant runs, otherwise a blueprint/content generation
content object | null null until the run completes. Shape depends on flow_type (below)

content — blueprint flow (flow_type ≠ ai_assistant)

Field Type Description
content_id string (uuid) The generated deliverable's ID. Pass to get_content if you need the body
name string Document name
blueprint_id integer Blueprint used to generate
link_url string Direct URL to view/open in Marcora

content — Content Assistant flow (flow_type = ai_assistant)

status is per-run, but content is the current state: the live document (which may include edits the user made themselves afterward) plus the most recent Content Assistant interaction on that document — intentionally not a frozen snapshot of this specific generation.

Field Type Description
content_id string (uuid) The canvas/deliverable the assistant acted on
name string | null Document name
document_type string canvas or deliverable
assistant_summary string | null The most recent assistant reply shown in the document's sidebar thread
document_updated boolean Whether the most recent interaction changed the document body (false for a reply-only / chat-only response)
current_content string | null The document's current markdown
link_url string Direct URL to view/open in Marcora

Example prompts

  • "Check on my content generation"
  • "Is my blog post done yet?"
  • "Did the assistant finish editing my document?"
Scroll to Top