read_board

Read one sheet; supply sheetId. Focus flowcharts with nodeIds/region/selector, documents with blockIds or section; Document tabs list pages, read one with documentId. view=full includes styles/rich text; includeVersions adds guards. For exact flowchart text/label field preconditions use includeRawText and copy rawText/rawLabel; compact/semantic text is normalized. Use specialized reads for Kanban, assets, reviews and data. Page with nextCursor + expectedRevision. Reuse mutation revisions/versions instead of rereading whole sheets. Details: /docs/mcp/read_board.

Use the smallest read that answers the edit: nodeIds for known flowchart nodes; blockIds for known document blocks; section={headingId} or section={heading,occurrence?} for a document section. Heading text matches exactly ignoring case and surrounding whitespace; repeated names require headingId or a 1-based occurrence. Sections include their heading and nested subsections until the next equal/higher-level heading. blockIds and section intersect, preserve document order and use the normal pagination rules. Filtered reads set partial=true even on the last page; nextCursor indicates more matching blocks. Do not reread the whole sheet after every successful edit: reuse revisionAfter and returned versions. Kanban tabs return columns and cards; use read_kanban(cardIds,columnId) for focused reads. Structured Data tabs return their table schemas; use read_data(tableId,recordIds) for records. Read one live sheet and its content revision. Document tabs return effective pageSettings, filtered/paginated top-level blocks, plain text and block versions; view=full includes structured rich-text content, plus the document sheet list. Supply sheetId explicitly. Omitted sheetId reads the original main sheet; if deleted, choose a sheet with list_sheets. Compact returns text/relationships (linkedTo, rows, loopedFrom: the linked copies and bundle rows {nodeId,row} that loop back to a node); layout returns geometry/edge routing; semantic adds extensions (qraft.role, board qraft.instructions); full returns all. Filter nodes by nodeIds, region (intersecting node bounds), and selector (role/shape/textContains, AND). Incident edges can reference nodes outside the result. Use returned IDs for mutations. includeVersions adds opaque board/node/edge content hashes for preconditions. Pages identify partial content; use nextCursor with its original revision.