Blueprints

list_blueprints

Get all blueprints in your team's library as a flat list, each with its content category and a direct web URL.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "required": [
    "blueprints"
  ],
  "properties": {
    "blueprints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Blueprint name."
          },
          "web_url": {
            "type": "string",
            "description": "Direct URL to view this blueprint in Marcora."
          },
          "category": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              }
            },
            "description": "Content category this blueprint belongs to: { id, name }. id matches list_content_categories."
          },
          "created_at": {
            "type": "integer",
            "description": "Unix timestamp (ms) of creation."
          },
          "content_count": {
            "type": "integer",
            "description": "Number of content items generated from this blueprint."
          },
          "blueprint_uuid": {
            "type": "string",
            "format": "uuid",
            "description": "Unique identifier — pass as blueprint_uuid to create_content."
          },
          "team_visibility": {
            "type": "string",
            "description": "Visibility within your team (e.g. team, private)."
          },
          "input_instructions": {
            "type": "string",
            "description": "Guidance on what context to provide when generating from this blueprint."
          },
          "exchange_visibility": {
            "type": "string",
            "description": "Community exchange visibility (e.g. public, none)."
          }
        }
      }
    }
  }
}

Instructions

Returns every blueprint in your team's library as a single flat array (across all content categories). Each blueprint includes its content category and a direct URL to view it in Marcora. Use the returned blueprint_uuid with create_content (passed as blueprint_uuid) to generate content from a blueprint.

Changed in v0.3.0: This tool previously returned an object wrapper with separate blueprints and blueprint_drafts arrays. It now returns a flat top-level array of published blueprints. In-progress blueprint drafts are no longer included in the response.

Clients that previously read the bare array must now read response.blueprints.

Examples

List all blueprints

Triggered by prompts like "Show me my blueprints", "What content templates do I have?", or "List all my content blueprints". Returns every published blueprint as a flat array — no parameters required.

Input

{}

Output

[
  {
    "blueprint_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Blog Post",
    "input_instructions": "Provide the topic, target audience, and key points to cover.",
    "team_visibility": "team",
    "exchange_visibility": "none",
    "content_count": 14,
    "created_at": 1712678400000,
    "category": { "id": 5, "name": "Blog" },
    "web_url": "https://app.marcora.ai/blueprints/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  {
    "blueprint_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "LinkedIn Post",
    "input_instructions": "Describe what you want to announce or share.",
    "team_visibility": "team",
    "exchange_visibility": "public",
    "content_count": 7,
    "created_at": 1713000000000,
    "category": { "id": 8, "name": "Social" },
    "web_url": "https://app.marcora.ai/blueprints/b2c3d4e5-f6a7-8901-bcde-f12345678901"
  }
]