Read

list_cards

Returns a flat array of all cards in the outline with stable IDs, stack info, kind, and content — the map you need before editing, reordering, or deleting.

Parameters

Name	Type	Required	Description
outlineId	string	—	Outline ID to query. Omit to use the authenticated creator's own outline.
stackId	string	—	Filter results to cards in a specific stack only. Useful for reducing agent context noise when you only need one section.

Response

Field	Type	What it means
outlineId	string	The resolved outline ID that was queried.
cards	array	Flat list of all cards (or cards in the specified stack). Empty array when the outline has no cards.
cards[].stackId	string	ID of the stack this card belongs to. Pass to add_stack queries or stackId filter.
cards[].stackTitle	string	Display title of the stack — the section heading visitors see.
cards[].cardId	string	Stable ID for this card. Use in update_card, delete_card, reorder_cards, and as afterCardId in add_card.
cards[].kind	string	Card template kind: basic, about, service, testimonial, contact, book-me, embed-booking, buy, or email.
cards[].heading	string	The card's main heading text.
cards[].subheading	string	The card's subheading text.
cards[].description	string	The card's body description text. May be empty string — expected for cards not yet filled in.

Example

Request

json

{}

Response

json

{
  "outlineId": "42",
  "cards": [
    {
      "stackId": "stack_abc",
      "stackTitle": "Portfolio",
      "cardId": "card_001",
      "kind": "about",
      "heading": "Alex Rivera",
      "subheading": "Portrait & Commercial Photographer",
      "description": "Based in Los Angeles. Available for editorial, brand, and event work."
    },
    {
      "stackId": "stack_abc",
      "stackTitle": "Portfolio",
      "cardId": "card_002",
      "kind": "service",
      "heading": "Brand Sessions",
      "subheading": "Half-day or full-day",
      "description": "In-studio or on-location brand photography for founders and creative teams."
    }
  ]
}

When to use

Call this before any edit operation. The cardId and stackId values returned here are the stable references needed by update_card, delete_card, reorder_cards, and add_card (as afterCardId). Also useful for auditing the current profile structure before proposing changes — you need the map before you redraw it.

Gotchas

Watch out

cardId and stackId are stable across sessions — safe to store and reference later without re-fetching.
An empty cards array means the outline exists but has no cards yet. Add stacks first with add_stack, then cards with add_card.
The description field may be empty string — that's expected for cards that haven't been filled in yet, not a data error.
Use the stackId filter parameter when you only need cards from one section. It reduces noise in the agent context and keeps responses fast on profiles with many cards.

← All tools ← MCP Guide