1 files changed, 1 insertions(+), 1 deletions(-)

M docs/DESIGN.mcp.md

@@ 250,7 250,7 @@ beads tracker", naming the generic tools as the way to read it anyway.
 | `list_databases` | — | every database the caller may list: owner, name, visibility, description, default branch, head hash + commit time, `is_beads` |
 | `list_branches` | db | branches with head hashes |
 | `list_tables` | db, ref? | table names, columns (name/type/pk/nullable), row counts |
-| `read_rows` | db, table, ref?, offset?, limit? | a page of rows as strings, plus the table total |
+| `read_rows` | db, table, ref?, offset?, limit? | a page of rows as strings-or-null (a cell holding no value is JSON `null`, so a real NULL is not the string `"NULL"`), plus the table total |
 | `get_commit_log` | db, ref?, from?, limit? | commits: hash, author, date, message, parents |
 | `get_commit_diff` | db, hash | the per-table summary `browse.CommitSummary` computes |