docs: propagate record-templates milestone — CHANGELOG, READMEs (52→61), Settings UI

CHANGELOG gets a new 2.5.0 section covering the 9 record template tools and
the round-4 user-report fixes carried in. Root + mcp-server READMEs bump
total to 61, expand Schema Read to 9, add a Record Templates (8) section.
Webview Settings descriptions updated for read/table-write/table-destructive
to reflect the new tool roster.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: ARHAEEM

CHANGELOG.md

@@ -6,6 +6,51 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 
 ## [Unreleased]
 
+### MCP Server 2.5.0 — Record Templates (9 new tools) + round-4 user-report fixes (2026-05-01)
+
+Promotes record templates to a first-class MCP capability. Templates are
+the saved row scaffolds that Airtable surfaces under the "+ Add record"
+flyout and inside the row-create extension — previously not addressable
+through any public or internal API client we had. Discovered by capturing
+the rowTemplate endpoints with `pnpm capture:cdp:mutations` while the
+reporter exercised every template UI path.
+
+**New tools (9):**
+
+| Tool | Category | Purpose |
+|:-----|:---------|:--------|
+| `list_record_templates` | read | List record templates for a table |
+| `create_record_template` | table-write | Create a template (client-side `rtp...` ID like view sections use `vsc...`) |
+| `rename_record_template` | table-write | Rename a template |
+| `update_record_template_description` | table-write | Set or clear a template's description |
+| `set_record_template_cell` | table-write | Set a cell value in a template (static, linked rows, or linked templates) |
+| `set_record_template_visible_columns` | table-write | Choose which columns the template surfaces in its UI |
+| `duplicate_record_template` | table-write | Clone an existing template |
+| `apply_record_template` | table-write | Apply a template — creates a new record using the template's cell defaults |
+| `delete_record_template` | table-destructive | Delete a template |
+
+**Round-4 fixes (carried into 2.5.0 from interim 2.4.4 work):**
+
+- `set_view_columns` now filters the primary column out of the move step
+  before calling `moveVisibleColumns` — Airtable rejects any move that
+  displaces the pinned primary at index 0.
+- `reorder_view_fields` `mergePartialFieldOrder` protects the primary
+  column at index 0; user-requested moves to index 0 are clamped to 1.
+- `update_view_group_levels` always sends `emptyGroupState: 'hidden'`;
+  Airtable's API rejects `'visible'` with INVALID_REQUEST.
+- `list_tables` now reads `data.tableById` as a fallback when
+  `tableSchemas` / `tables` / `tableDatas` are absent (matches the shape
+  the reporter saw).
+- `update_view_filters` `isWithin` corrected: requires `timeZone` (IANA)
+  and `shouldUseCorrectTimeZoneForFormulaicColumn: true`, no `exactDate`,
+  modes are `thisCalendarMonth` / `thisCalendarYear` (not `thisMonth` /
+  `thisYear`). Tool description and AI skill template updated.
+
+**Counts:** 52 → **61 tools**. `read-only` profile: 8 → 9. `safe-write`
+profile: 39 → 47. `full` profile: 52 → 61.
+
+mcp-server: 2.4.4 → 2.5.0.
+
 ### MCP Server 2.4.3 — `list_view_sections` full fix (carry-over from 2.4.2)
 
 Probed the schema read response with a fresh patchright session against

README.md

@@ -131,17 +131,18 @@ This monorepo ships **two products** from one source tree:
 - **Dashboard** — React webview with Overview, Setup, and Settings tabs
 
 
-### MCP Server (52 Tools)
+### MCP Server (61 Tools)
 
 Manage Airtable bases with capabilities **not available through the official REST API**:
 
 | Category | Tools | Highlights |
 |:---------|:-----:|:-----------|
-| **Schema Read** | 8 | Full schema inspection — bases, tables, fields, views, sidebar sections |
+| **Schema Read** | 9 | Full schema inspection — bases, tables, fields, views, sidebar sections, record templates |
 | **Table Management** | 3 | create / rename / delete tables |
 | **Field Management** | 8 | Create formula / rollup / lookup / count fields, validate formulas, update descriptions, delete |
 | **View Configuration** | 20 | Filters, sorts, grouping, columns, freezing, row height, covers, color rules, calendar dates, create / duplicate / rename / delete |
 | **Sidebar Sections** | 4 | Create, rename, move-into-section, delete (auto-promotes contained views to ungrouped) |
+| **Record Templates** | 8 | Create / rename / describe / set cells / set columns / duplicate / apply / delete saved row scaffolds |
 | **Form Metadata** | 2 | Description, redirect URL, attribution, copy-to-respondent, branding (legacy form views) |
 | **Extension Management** | 7 | Create, install, enable/disable, rename, duplicate, remove extensions |
 

packages/mcp-server/README.md

@@ -91,7 +91,7 @@ The official Airtable MCP is a thin wrapper over the public Web API. That API 
 npx airtable-user-mcp
 ```
 
-That's it. Your MCP client connects via **stdio** and gets access to all 52 tools.
+That's it. Your MCP client connects via **stdio** and gets access to all 61 tools.
 
 ---
 
@@ -208,7 +208,7 @@ Add the `airtable` entry to `mcpServers`:
 }
 ```
 
-Save, then **fully quit and reopen Claude Desktop** (closing the window is not enough). A hammer/plug icon in the chat input confirms the server is connected — click it to see the 52 tools.
+Save, then **fully quit and reopen Claude Desktop** (closing the window is not enough). A hammer/plug icon in the chat input confirms the server is connected — click it to see the 61 tools.
 
 </details>
 
@@ -231,7 +231,7 @@ Verify:
 claude mcp list
 ```
 
-You should see `airtable: npx -y airtable-user-mcp - ✓ Connected`. Start a Claude Code session in that directory and the 52 tools are available.
+You should see `airtable: npx -y airtable-user-mcp - ✓ Connected`. Start a Claude Code session in that directory and the 61 tools are available.
 
 </details>
 
@@ -332,9 +332,9 @@ npx airtable-user-mcp --help           Show this help
 
 ---
 
-## Tools (52)
+## Tools (61)
 
-### Schema Read (8)
+### Schema Read (9)
 
 | Tool | Description |
 |:-----|:------------|
@@ -346,6 +346,7 @@ npx airtable-user-mcp --help           Show this help
 | `get_view` | Read a single view's full state — filters, sorts, grouping, visibility, description |
 | `validate_formula` | Validate a formula expression before applying |
 | `list_view_sections` | List sidebar sections for a table with their view membership |
+| `list_record_templates` | List record templates (saved row scaffolds) for a table |
 
 ### Table Management (3)
 
@@ -402,6 +403,21 @@ npx airtable-user-mcp --help           Show this help
 | `move_view_to_section` | Move view INTO a section, OUT to ungrouped, reorder within a section, or reorder sections among each other |
 | `delete_view_section` | Destroy a section. Contained views are auto-promoted to ungrouped at the section's former position |
 
+### Record Templates (8)
+
+Saved row scaffolds Airtable surfaces under "+ Add record" and the row-create extension. Cell values can be static, linked rows, or references to other templates.
+
+| Tool | Description |
+|:-----|:------------|
+| `create_record_template` | Create a new record template (client-side `rtp...` ID) |
+| `rename_record_template` | Rename a template |
+| `update_record_template_description` | Set or clear a template's description |
+| `set_record_template_cell` | Set a cell value — `static` (text/number/select), `linkedRows`, or `linkedTemplates` |
+| `set_record_template_visible_columns` | Choose which columns the template surfaces in its UI |
+| `duplicate_record_template` | Clone an existing template |
+| `apply_record_template` | Apply a template to create a new record using its cell defaults |
+| `delete_record_template` | Delete a template |
+
 ### Form Metadata (2 — legacy form views only)
 
 | Tool | Description |

packages/webview/src/tabs/Settings.tsx

@@ -557,9 +557,9 @@ export function Settings() {
 
           {settings.mcp.toolProfile.profile === 'custom' && (
             <div className="stack stack-sm" style={{ paddingTop: 4, borderTop: '1px solid var(--border)', marginTop: 4 }}>
-              <SettingToggle label="Read / Inspect"       desc="Schema, fields, views, formula validation, list_view_sections (8 tools)"     value={settings.mcp.toolProfile.categories.read}                   settingKey="mcp.categories.read" />
-              <SettingToggle label="Table Write"          desc="create_table, rename_table (2 tools)"                                         value={settings.mcp.toolProfile.categories.tableWrite}             settingKey="mcp.categories.tableWrite" />
-              <SettingToggle label="Table Destructive"    desc="delete_table (1 tool)"                                                        value={settings.mcp.toolProfile.categories.tableDestructive}       settingKey="mcp.categories.tableDestructive" />
+              <SettingToggle label="Read / Inspect"       desc="Schema, fields, views, formula validation, sidebar sections, record templates (9 tools)" value={settings.mcp.toolProfile.categories.read}                   settingKey="mcp.categories.read" />
+              <SettingToggle label="Table Write"          desc="Tables + record templates: create / rename / update / set cells / duplicate / apply (9 tools)" value={settings.mcp.toolProfile.categories.tableWrite}             settingKey="mcp.categories.tableWrite" />
+              <SettingToggle label="Table Destructive"    desc="delete_table, delete_record_template (2 tools)"                              value={settings.mcp.toolProfile.categories.tableDestructive}       settingKey="mcp.categories.tableDestructive" />
               <SettingToggle label="Field Write"          desc="Create / update / rename / duplicate fields (7 tools)"                        value={settings.mcp.toolProfile.categories.fieldWrite}             settingKey="mcp.categories.fieldWrite" />
               <SettingToggle label="Field Destructive"    desc="delete_field (1 tool)"                                                        value={settings.mcp.toolProfile.categories.fieldDestructive}       settingKey="mcp.categories.fieldDestructive" />
               <SettingToggle label="View Write"           desc="Views, filters, sorts, columns, freezing, covers, calendar dates (19 tools)" value={settings.mcp.toolProfile.categories.viewWrite}              settingKey="mcp.categories.viewWrite" />