MCP SERVEREdit tables inside Markdown files by column name or letter, with a version hash that makes a stale write fail instead of silently overwrite.
LABSCO SUMMARY
Everything else follows from that decision. Reads exist to mint hashes, which is why search_tables and list_tables return one alongside every hit rather than making you call read_table again, and why a successful write returns v:{new_hash} so consecutive edits chain without a re-read. The descriptions argue against grep for the same reason — a regex over raw text does not know a column from a cell, and an HTML table in a GitBook file does not look like a table to it. The narrow claim here is worth taking literally: this handles tables inside Markdown, addressed by index within one file, and stops there.
A table-editing server for Markdown files, exposing 11 tools that address tables by index within a file and guard every write with the version hash a read returned.
A Markdown file the server can write to, and a read before every edit — each write tool takes the version hash that read_table, list_tables or search_tables returned.
One command — uvx tablestakes
USE CASES
Read the table to get its current hash, send the cell updates against that hash, and let the write fail rather than clobber if the file moved.
Search by value across every table in the file, then edit or drop the matching row using the hash the search already returned.
Check the shape and hash first, insert the column with a default filled into existing rows, and rename or drop headers without touching row data.
Read the table through the server rather than the raw file, insert the row by column name, and let the write-back preserve the original markup.
Create it in the format the file needs, and use the hash the creation returned to begin editing immediately.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_tableCreate a new table in a Markdown file. Provide content as a pipe table.
The table is written in the specified format: "html" (default, collapsed single-line HTML suitable for GitBook) or "pipe" (GFM pipe table).
No version hash needed — this creates, not edits.
On success returns v:{hash} of the new table. Use this hash with read_table and write tools to edit the table immediately. On error returns JSON with "error" and "message" fields.
delete_columnDelete a column. Requires version hash from read_table.
On success returns ONLY v:{new_hash}. On error returns JSON with "error" and "message" fields.
delete_rowDelete a row. Requires version hash from read_table.
On success returns ONLY v:{new_hash}. On error returns JSON with "error" and "message" fields.
insert_columnInsert a new column. Requires version hash from read_table.
All existing rows are populated with default_value (empty string if omitted).
On success returns ONLY v:{new_hash}. On error returns JSON with "error" and "message" fields.
insert_rowInsert a new row. Requires version hash from read_table.
Provide values as a dict mapping column identifiers to cell content. Column identifiers: letter ("A"), name ("Priority"), or composite ("B:Priority"). Omitted columns default to empty string.
On success returns ONLY v:{new_hash}. On error returns JSON with "error" and "message" fields.
list_tablesList all tables in a Markdown file with column descriptors and row previews.
Prefer this over grep for discovering table structure — returns column names, row counts, formats, and version hashes. Use search_tables to find specific data across tables.
read_tableRead a full table as a clean pipe table with version hash.
Prefer this over reading files directly — handles HTML tables, preserves inline formatting, and returns the version hash needed for any edit.
First line of output is metadata: v:{hash} {format} {rows}r {cols}c [{section}] Extract the 12-char hex hash after "v:" (e.g. "a1b2c3d4e5f6") and pass it as the version argument to any write tool.
If a write returns STALE_READ, call read_table again for a fresh version.
rename_columnRename a column header. Row data is unchanged. Requires version from read_table.
On success returns ONLY v:{new_hash}. On error returns JSON with "error" and "message" fields.
replace_tableReplace an entire table with new content. Requires version from read_table.
Provide new_content as a pipe table string (header row + delimiter + data rows). The server writes back in the ORIGINAL file format: pipe stays pipe, GitBook HTML stays GitBook HTML (attributes preserved).
On success returns ONLY v:{new_hash}. On error returns JSON with "error" and "message" fields.
search_tablesSearch for rows matching a value across one or all tables in a file.
Returns matching rows with table index, row index, and version hash so you can immediately follow up with a write tool. Prefer this over grep for table data — it understands column structure and handles HTML tables.
Two search modes (regex overrides pattern if both given):
D 1\.\d+` for sub-items)If neither pattern nor regex is provided, returns all rows.
update_cellsBatch-update cells. Requires version hash from read_table.
Each update is {row, column, value} where:
On success returns ONLY v:{new_hash}. On error returns JSON: {"error": "STALE_READ"|"EDIT_ERROR"|..., "message": "..."}. If STALE_READ: call read_table again for current version, then retry.
BEFORE YOU INSTALL
11 tools when we connected.
uvx on PATH
CONTEXT COST
Rated by the size of the 11 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Add the block to your client, or run the command directly.
{
"mcpServers": {
"tablestakes": {
"command": "uvx",
"args": [
"tablestakes"
]
}
}
}uvx tablestakesMCP servers
haris-musa
Automations-Project
eiceblue
kousunh