Blueprints

create_blueprint_draft

Create an AI-assisted blueprint draft from a prompt that the user can review and edit in Marcora before publishing. Use create_blueprint instead if you already have the finished template content.

Parameters

Name	Type	Required	Default	Description
`instructions`	`string`	Yes	—	Prompt describing the blueprint to create (e.g. "A weekly product update email with sections for new features, fixes, and a tip of the week").
`name`	`string`	Yes	—	Display name for the draft (visible in the user's app).
`content`	`string`	Yes	—	Initial markdown content the AI will iterate on. Can be empty to let the AI generate from instructions alone.
`category_id`	`integer`	No	—	Optional content category id from list_content_categories.

Input Schema

{
  "type": "object",
  "required": [
    "instructions",
    "name",
    "content"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name for the draft (visible in the user's app)."
    },
    "content": {
      "type": "string",
      "description": "Initial markdown content the AI will iterate on. Can be empty to let the AI generate from instructions alone."
    },
    "category_id": {
      "type": "integer",
      "description": "Optional content category id from list_content_categories."
    },
    "instructions": {
      "type": "string",
      "description": "Prompt describing the blueprint to create (e.g. \"A weekly product update email with sections for new features, fixes, and a tip of the week\")."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "id",
    "uuid",
    "title",
    "content",
    "link_url"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Record ID for the blueprint draft"
    },
    "uuid": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for this draft — pass as draft_uuid to finalize_blueprint_draft."
    },
    "title": {
      "type": "string",
      "description": "Blueprint draft name"
    },
    "content": {
      "type": "string",
      "description": "AI-generated blueprint template content in markdown"
    },
    "link_url": {
      "type": "string",
      "format": "uri",
      "description": "Direct URL to view/edit this blueprint draft in Marcora"
    }
  }
}

Instructions

Use this tool to create an AI-assisted blueprint DRAFT from a prompt.

Important: This creates a draft blueprint template you can review before saving as a full blueprint — it does not create content directly.

Workflow:

Provide instructions describing the blueprint you want to create.
Provide a name for the draft.
Provide initial content as markdown.
Optionally get category_id from list_content_categories.
Review the AI-generated result, then have the user visit the link_url to finalize the blueprint.