@addai/tables-mcp 0.7.0

package/dist/helpers/validate-options.d.ts

@@ -0,0 +1,34 @@
+import type { AiTablesClient } from '../api-client.js';
+import type { ColumnMap } from './mapped-columns.js';
+export interface OptionViolation {
+    column: string;
+    columnId: string;
+    type: string;
+    invalidValues: string[];
+    validOptions: string[];
+}
+/**
+ * Scan name-keyed row payloads for select/multiselect values that don't match the
+ * column's configured options. Aggregates invalid values per column across all rows.
+ * Columns with no configured options are skipped — there's nothing to validate
+ * against, and rejecting would break writes to legitimately option-less columns.
+ */
+export declare function findOptionViolations(rows: Record<string, unknown>[], map: ColumnMap): OptionViolation[];
+/**
+ * Human-readable rejection message listing each offending column, its bad values,
+ * and the valid options — plus how to opt into adding them.
+ */
+export declare function formatOptionViolations(violations: OptionViolation[]): string;
+/**
+ * Add each violation's invalid values as new options on its column, preserving
+ * existing options and their colors (reuses the same merge as update_column).
+ * Returns an error string on the first failure.
+ */
+export declare function addMissingOptions(client: AiTablesClient, tableId: string, violations: OptionViolation[], map: ColumnMap): Promise<{
+    error?: string;
+    added: {
+        column: string;
+        options: string[];
+    }[];
+}>;
+//# sourceMappingURL=validate-options.d.ts.map

package/dist/helpers/validate-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-options.d.ts","sourceRoot":"","sources":["../../src/helpers/validate-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AASrD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA0BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,GAAG,EAAE,SAAS,GACb,eAAe,EAAE,CAqCnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAa5E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,EAAE,EAC7B,GAAG,EAAE,SAAS,GACb,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CA0B7E"}

package/dist/helpers/validate-options.js

@@ -0,0 +1,120 @@
+import { mergeSelectOptions } from './column-settings.js';
+// Column types whose cell values must match a configured option set.
+// Intentionally scoped to select + multiselect: `tags` are free-form by design,
+// and `label` seeds preset options that callers don't necessarily want enforced.
+const VALIDATED_TYPES = new Set(['select', 'multiselect']);
+/** Extract the configured option value strings for a select/multiselect column. */
+function configuredOptionValues(col) {
+    const settings = (col.column_settings || {});
+    const opts = settings.options || [];
+    return opts
+        .map((o) => (typeof o === 'string' ? o : o?.value))
+        .filter((v) => typeof v === 'string');
+}
+/** Pull the string value(s) a caller supplied for a select/multiselect cell. */
+function candidateValues(value) {
+    if (value === null || value === undefined || value === '')
+        return [];
+    const arr = Array.isArray(value) ? value : [value];
+    const out = [];
+    for (const v of arr) {
+        if (typeof v === 'string') {
+            if (v.length > 0)
+                out.push(v);
+        }
+        else if (v && typeof v === 'object' && typeof v.value === 'string') {
+            out.push(v.value);
+        }
+    }
+    return out;
+}
+/**
+ * Scan name-keyed row payloads for select/multiselect values that don't match the
+ * column's configured options. Aggregates invalid values per column across all rows.
+ * Columns with no configured options are skipped — there's nothing to validate
+ * against, and rejecting would break writes to legitimately option-less columns.
+ */
+export function findOptionViolations(rows, map) {
+    const colById = new Map(map.columns.map((c) => [c.id, c]));
+    const agg = new Map();
+    for (const row of rows) {
+        for (const [key, value] of Object.entries(row)) {
+            // Resolve key → column, accepting either a human name or a raw column id
+            // (mirrors translateToIds so validation and translation agree on the target).
+            const columnId = map.nameToId.get(key) ?? (colById.has(key) ? key : undefined);
+            if (!columnId)
+                continue;
+            const col = colById.get(columnId);
+            if (!col || !VALIDATED_TYPES.has(col.column_type))
+                continue;
+            const valid = configuredOptionValues(col);
+            if (valid.length === 0)
+                continue;
+            const validSet = new Set(valid);
+            for (const cand of candidateValues(value)) {
+                if (!validSet.has(cand)) {
+                    let entry = agg.get(col.id);
+                    if (!entry) {
+                        entry = { col, invalid: new Set(), valid };
+                        agg.set(col.id, entry);
+                    }
+                    entry.invalid.add(cand);
+                }
+            }
+        }
+    }
+    return [...agg.values()].map((e) => ({
+        column: e.col.name,
+        columnId: e.col.id,
+        type: e.col.column_type,
+        invalidValues: [...e.invalid],
+        validOptions: e.valid,
+    }));
+}
+/**
+ * Human-readable rejection message listing each offending column, its bad values,
+ * and the valid options — plus how to opt into adding them.
+ */
+export function formatOptionViolations(violations) {
+    const lines = violations.map((v) => {
+        const bad = v.invalidValues.map((s) => `"${s}"`).join(', ');
+        const valid = v.validOptions.length ? v.validOptions.join(', ') : '(none configured)';
+        const label = v.invalidValues.length > 1 ? 'values' : 'value';
+        return `  • "${v.column}" (${v.type}): invalid ${label} ${bad}. Valid options: ${valid}`;
+    });
+    return ("Rejected — some select/multiselect values do not match the column's configured options:\n" +
+        lines.join('\n') +
+        '\n\nFix the value(s) to match an option above, or call again with add_missing_options: true ' +
+        'to add the new option(s) to the column before writing.');
+}
+/**
+ * Add each violation's invalid values as new options on its column, preserving
+ * existing options and their colors (reuses the same merge as update_column).
+ * Returns an error string on the first failure.
+ */
+export async function addMissingOptions(client, tableId, violations, map) {
+    const colById = new Map(map.columns.map((c) => [c.id, c]));
+    const added = [];
+    for (const v of violations) {
+        const col = colById.get(v.columnId);
+        if (!col)
+            continue;
+        const existingSettings = (col.column_settings || {});
+        const existingOptions = existingSettings.options || [];
+        const existingValues = existingOptions.map((o) => o.value);
+        const fullList = [
+            ...existingValues,
+            ...v.invalidValues.filter((val) => !existingValues.includes(val)),
+        ];
+        const merged = mergeSelectOptions(existingOptions, fullList);
+        const res = await client.patch(`/tables/${tableId}/columns/${v.columnId}`, {
+            column_settings: { ...existingSettings, options: merged },
+        });
+        if (res.error) {
+            return { error: `Failed to add option(s) to "${v.column}": ${res.error.message}`, added };
+        }
+        added.push({ column: v.column, options: v.invalidValues });
+    }
+    return { added };
+}
+//# sourceMappingURL=validate-options.js.map

package/dist/helpers/validate-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-options.js","sourceRoot":"","sources":["../../src/helpers/validate-options.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+// If --setup flag is passed, run interactive setup instead of MCP server
+if (process.argv.includes('--setup') || process.argv.includes('setup')) {
+    await import('./setup.js');
+}
+else {
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { createServer } = await import('./server.js');
+    const apiKey = process.env.AITABLES_API_KEY;
+    if (!apiKey) {
+        console.error('Error: AITABLES_API_KEY environment variable is required.\n\n' +
+            'Run setup to configure automatically:\n' +
+            '  npx aitables-mcp --setup\n\n' +
+            'Or manually add to your .mcp.json:\n' +
+            '  {\n' +
+            '    "mcpServers": {\n' +
+            '      "aitables": {\n' +
+            '        "command": "npx",\n' +
+            '        "args": ["-y", "aitables-mcp"],\n' +
+            '        "env": {\n' +
+            '          "AITABLES_API_KEY": "ait_user_xxxx"\n' +
+            '        }\n' +
+            '      }\n' +
+            '    }\n' +
+            '  }');
+        process.exit(1);
+    }
+    const baseUrl = process.env.AITABLES_API_URL || undefined;
+    const server = createServer(apiKey, baseUrl);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,yEAAyE;AACzE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;AAC7B,CAAC;KAAM,CAAC;IACN,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,+DAA+D;YAC7D,yCAAyC;YACzC,gCAAgC;YAChC,sCAAsC;YACtC,OAAO;YACP,uBAAuB;YACvB,uBAAuB;YACvB,6BAA6B;YAC7B,2CAA2C;YAC3C,oBAAoB;YACpB,iDAAiD;YACjD,aAAa;YACb,WAAW;YACX,SAAS;YACT,KAAK,CACR,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/logo.d.ts

@@ -0,0 +1,2 @@
+export declare function printLogo(): void;
+//# sourceMappingURL=logo.d.ts.map

package/dist/logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../src/logo.ts"],"names":[],"mappings":"AAwCA,wBAAgB,SAAS,IAAI,IAAI,CAiChC"}

package/dist/logo.js

@@ -0,0 +1,64 @@
+// AiTables logo - 2x4 color grid + sleek block-letter wordmark
+const rgb = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const B = '\u2588';
+const W = 8;
+const C = {
+    g1: rgb(228, 140, 60),
+    g2: rgb(210, 100, 120),
+    g3: rgb(180, 85, 150),
+    g4: rgb(150, 160, 200),
+    pale: rgb(230, 234, 242),
+    lavender: rgb(172, 166, 204),
+    mint: rgb(170, 224, 216),
+    indigo: rgb(108, 108, 172),
+    cyan: rgb(68, 196, 200),
+    blue: rgb(136, 152, 208),
+    teal: rgb(120, 208, 206),
+};
+function cell(color, width = W) {
+    return color + B.repeat(width) + RESET;
+}
+function gradCell() {
+    return C.g1 + B.repeat(2) + C.g2 + B.repeat(2) + C.g3 + B.repeat(2) + C.g4 + B.repeat(2) + RESET;
+}
+// Sleek 2-line block wordmark using ▄ ▀ █
+// A     i    T     a     b     l    e     s
+const WORD_L1 = '\u2584\u2580\u2588 \u2580 \u2580\u2588\u2580 \u2584\u2580\u2588 \u2588\u2584\u2584 \u2588  \u2588\u2580\u2580 \u2588\u2580';
+const WORD_L2 = '\u2588\u2580\u2588 \u2588  \u2588  \u2588\u2580\u2588 \u2588\u2584\u2588 \u2588\u2584 \u2588\u2588\u2584 \u2584\u2588';
+const TC1 = rgb(170, 178, 220); // lighter blue-lavender
+const TC2 = rgb(120, 140, 200); // slightly deeper
+const SC = rgb(68, 196, 200);
+export function printLogo() {
+    const logo = [
+        gradCell() + cell(C.pale),
+        gradCell() + cell(C.pale),
+        cell(C.lavender) + cell(C.mint),
+        cell(C.lavender) + cell(C.mint),
+        cell(C.indigo) + cell(C.cyan),
+        cell(C.indigo) + cell(C.cyan),
+        cell(C.blue) + cell(C.teal),
+        cell(C.blue) + cell(C.teal),
+    ];
+    // Wordmark positioned to right, vertically centered
+    const wordmark = [
+        `${BOLD}${TC1}${WORD_L1}${RESET}`,
+        `${BOLD}${TC2}${WORD_L2}${RESET}`,
+    ];
+    const wmOffset = 3; // start wordmark at line 3 (vertically centered)
+    console.log('');
+    for (let i = 0; i < logo.length; i++) {
+        let right = '';
+        const wIdx = i - wmOffset;
+        if (wIdx >= 0 && wIdx < wordmark.length) {
+            right = '  ' + wordmark[wIdx];
+        }
+        if (i === wmOffset + wordmark.length + 1) {
+            right = `  ${SC}Connect your data to Claude${RESET}`;
+        }
+        console.log('  ' + logo[i] + right);
+    }
+    console.log('');
+}
+//# sourceMappingURL=logo.js.map

package/dist/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../src/logo.ts"],"names":[],"mappings":"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"}

package/dist/preview.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":""}

package/dist/preview.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { printLogo } from './logo.js';
+printLogo();
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,SAAS,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(apiKey: string, baseUrl?: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqHpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAyBxE"}

package/dist/server.js

@@ -0,0 +1,136 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { AiTablesClient } from './api-client.js';
+import { registerDiscoveryTools } from './tools/discovery.js';
+import { registerRowTools } from './tools/rows.js';
+import { registerStructureTools } from './tools/structure.js';
+import { registerSearchTools } from './tools/search.js';
+import { registerCommentTools } from './tools/comments.js';
+import { registerDashboardTools } from './tools/dashboards.js';
+import { registerFolderTools } from './tools/folders.js';
+import { registerViewTools } from './tools/views.js';
+import { registerHistoryTools } from './tools/history.js';
+import { registerFileTools } from './tools/files.js';
+const SERVER_INSTRUCTIONS = `You are connected to an AiTables database. AiTables is a database builder (like Airtable) with workspaces, databases, tables, columns, and rows.
+
+## Data Hierarchy
+Workspace → Database → Table → Columns + Rows
+
+## Workflow
+1. Use list_workspaces and list_databases to discover what exists
+2. Use list_tables to see tables in a database
+3. ALWAYS call get_table_schema before reading or writing rows — you need the column names
+4. Use list_rows to read data, create_rows to add data, update_rows to modify data
+
+## Looking up a single record by ID
+If you have a record/row ID (e.g. a task or bug id) but not its table, call **get_row** with just the row_id — the server resolves which table it belongs to (native or BYODB) and returns a "table" context block alongside the row. Use that table_id for any follow-up update_rows / add_comment. If you already know the table, pass table_id too for a faster direct fetch. Do NOT go hunting for the table_id by listing databases/tables first.
+
+## Column Types
+When creating tables or columns, choose from:
+- **Text:** text, richtext, email, url, phone
+- **Numbers:** number, rating, progress, duration
+- **Choices:** select (single choice), multiselect (multiple), tags, label
+- **Dates:** date, timeline (date range), hour (time of day), week
+- **People:** people (workspace users), team
+- **Logic:** boolean (checkbox), checklist
+- **Special:** country, color_picker, location, autonumber, barcode, vote
+
+For select/multiselect columns, provide the option values (e.g. ["Todo", "In Progress", "Done"]) and colors are auto-assigned.
+IMPORTANT: Do NOT create select/multiselect columns without options — they will appear as empty unusable dropdowns.
+
+## Row Data Format
+Use column names as keys (not UUIDs). Examples:
+- Select: { "Status": "In Progress" }
+- Date: { "Due Date": "2026-04-01" }
+- Boolean: { "Completed": true }
+- Number: { "Score": 85 }
+- Multiselect: { "Tags": ["urgent", "bug"] }
+
+Values for select/multiselect must exactly match defined options.
+
+## Common Tasks
+- **Create a tracker:** create_table with columns like Name (text), Status (select with options), Priority (select), Due Date (date), Assignee (people)
+- **Add data:** get_table_schema first, then create_rows with column names from the schema
+- **Update cells:** update_rows with just the columns you want to change
+- **Find data:** search_rows for cross-column text search, or list_rows with filters for precise queries
+- **Bulk operations:** create_rows and update_rows accept arrays for batch operations
+
+## Folders
+Two separate kinds of folders organise the hierarchy:
+- **Table folders** group TABLES inside one database. They can nest (parent_folder_id). Tools: list_table_folders, create_table_folder, update_table_folder, delete_table_folder, and move_table_to_folder (pass folder_id=null to move a table back to the database root).
+- **Database folders** group DATABASES inside a workspace. Tools: list_database_folders, create_database_folder, update_database_folder, delete_database_folder, and move_database_to_folder (folder_id=null moves it to the workspace root).
+
+Creating a folder does NOT put anything in it — create the folder, then call the matching move_*_to_folder tool. Deleting a folder only removes the grouping; the tables/databases inside survive and return to the root.
+
+## Editing & deleting structure
+- **Databases:** get_database, update_database (name/description/icon), delete_database.
+- **Tables:** update_table (name/description/icon), delete_table.
+- **Columns:** delete_column.
+Deletes cascade (deleting a database removes its tables/rows; deleting a table removes its rows; deleting a column drops that column's data everywhere) and cannot be undone — confirm with the user first.
+
+## Views
+A view is a saved presentation of a table's rows. Each has a view_type (table, kanban, calendar, gallery, timeline, list, gantt, form, dashboard, document) and a view_settings JSON blob holding that view's filters, sorts, grouping, hidden columns, and type-specific config (e.g. kanban's groupBy column, calendar's date column).
+- **list_views** / **get_view** / **create_view** / **update_view** / **delete_view**, plus **reorder_views**.
+- A table always keeps at least one view — deleting the last one fails.
+- view_settings is REPLACED wholesale on update — get_view first and merge if you only want to change part of it. The settings shape is type-specific, so inspect an existing view of the same type before building one.
+- **Share links:** list_view_shares / create_view_share (returns a public share_token, view or edit level) / deactivate_view_share.
+
+## Edit history (read-only)
+Every cell change is logged with its old value, new value, column, editor, and timestamp.
+- **get_row_history** — the full change log for one row (newest first).
+- **get_table_history** — paginated change log across the whole table, for auditing recent activity.
+
+## Files (FILE columns)
+To put a real file into a FILE-type column, use **upload_file** with a local file path. It streams the bytes straight to storage (so large files work) and stores them under the table's workspace. Either:
+- pass row_id + column_id (the FILE column from get_table_schema) and it writes the file into that cell directly (appending for multi-file columns), or
+- omit them and it returns a "file" value object {fileId,name,url,size,type} — then call update_rows yourself with that object as the column's value.
+Do NOT try to set a FILE column to a plain string/URL by hand — always upload through upload_file so the file actually exists in storage.
+
+## Comments
+Every row can have threaded comments with emoji reactions.
+- **list_comments** to see all comments on a row (includes user info, replies, reactions)
+- **add_comment** to post a comment or reply to an existing comment
+- **toggle_reaction** to add/remove an emoji reaction on a comment
+
+## Dashboards
+Dashboards are views with visual panels (stats, charts, embedded views, embeds, widgets) laid out on a 12-column grid. They can attach to three scopes:
+- **table** — dashboard lives on a single table (parent_id = table_id). **Fully rendered by the UI.**
+- **folder** — dashboard lives in a table folder (parent_id = folder_id). **Persists but the current UI does not render per-panel cross-table data yet** — panels will appear blank.
+- **database** — dashboard lives at the database level (parent_id = database_id). **Same rendering limitation as folder scope.**
+
+**Strongly prefer table-scope.** Only create folder/database-scope dashboards if the user explicitly asks and accepts the current blank-render limitation.
+
+All dashboard tools take **scope** + **parent_id**:
+- **list_dashboards** / **get_dashboard** / **create_dashboard** / **update_dashboard** / **delete_dashboard**
+- **add_panel** / **update_panel** / **delete_panel** / **move_panel** for incremental panel changes
+
+Panel types:
+- **stat** — KPI card. config: statType (count|sum|average|min|max|unique), column?, format, icon
+- **chart** — bar|pie|doughnut|line. config: chartType, groupByColumn, valueColumn?, aggregation
+- **view** — embedded table/gallery/list/kanban/calendar/gantt/timeline/document
+- **embed** — iframe/youtube/vimeo/figma/loom. config: url, embedType
+- **widget** — custom widget. config: widgetId, stateMapping
+
+For **folder/database-scope** dashboards, set **panel.table_id** on each panel so the tool knows which table to read columns from. For table-scope dashboards, panels inherit the dashboard's table automatically.
+
+Use **column NAMES** in panel configs and filters — tools translate to UUIDs. Call **get_table_schema** first to see available columns.`;
+export function createServer(apiKey, baseUrl) {
+    const server = new McpServer({
+        name: 'aitables-mcp',
+        version: '0.1.0',
+    }, {
+        instructions: SERVER_INSTRUCTIONS,
+    });
+    const client = new AiTablesClient(apiKey, baseUrl);
+    registerDiscoveryTools(server, client);
+    registerRowTools(server, client);
+    registerStructureTools(server, client);
+    registerSearchTools(server, client);
+    registerCommentTools(server, client);
+    registerDashboardTools(server, client);
+    registerFolderTools(server, client);
+    registerViewTools(server, client);
+    registerHistoryTools(server, client);
+    registerFileTools(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wIAsG4G,CAAC;AAEzI,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAgB;IAC3D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnD,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":""}

package/dist/setup.js

@@ -0,0 +1,128 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as readline from 'readline';
+import { printLogo } from './logo.js';
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+const MCP_ENTRY = {
+    command: 'npx',
+    args: ['-y', 'aitables-mcp'],
+    env: { AITABLES_API_KEY: '' },
+};
+function getConfigTargets() {
+    const platform = os.platform();
+    const home = os.homedir();
+    const targets = [];
+    // Claude Desktop
+    if (platform === 'win32') {
+        targets.push({
+            name: 'Claude Desktop',
+            path: path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json'),
+            wrapperKey: 'mcpServers',
+        });
+    }
+    else if (platform === 'darwin') {
+        targets.push({
+            name: 'Claude Desktop',
+            path: path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+            wrapperKey: 'mcpServers',
+        });
+    }
+    // Claude Code (global)
+    targets.push({
+        name: 'Claude Code (global)',
+        path: path.join(home, '.claude.json'),
+        wrapperKey: 'mcpServers',
+    });
+    return targets;
+}
+function readJsonFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+function writeJsonFile(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+async function run() {
+    printLogo();
+    console.log('  This will configure Claude to access your AiTables data.');
+    console.log('');
+    // Ask for API key
+    console.log('  1. Go to AiTables → open any database → menu → API Keys');
+    console.log('  2. Create a new key and copy it');
+    console.log('');
+    const apiKey = (await ask('  Paste your API key (ait_user_...): ')).trim();
+    if (!apiKey) {
+        console.log('\n  No API key provided. Setup cancelled.');
+        rl.close();
+        process.exit(1);
+    }
+    if (!apiKey.startsWith('ait_user_') && !apiKey.startsWith('ait_live_') && !apiKey.startsWith('ait_ent_')) {
+        console.log('\n  Warning: Key doesn\'t look like an AiTables key (expected ait_user_*, ait_live_*, or ait_ent_*)');
+        const cont = (await ask('  Continue anyway? (y/n): ')).trim().toLowerCase();
+        if (cont !== 'y') {
+            rl.close();
+            process.exit(1);
+        }
+    }
+    // Detect available config targets
+    const targets = getConfigTargets();
+    console.log('');
+    console.log('  Where would you like to install?');
+    targets.forEach((t, i) => {
+        const exists = fs.existsSync(t.path);
+        console.log(`  ${i + 1}. ${t.name}${exists ? '' : ' (will create config)'}`);
+    });
+    console.log(`  ${targets.length + 1}. Both`);
+    console.log('');
+    const choice = (await ask(`  Choose (1-${targets.length + 1}): `)).trim();
+    const choiceNum = parseInt(choice);
+    let selectedTargets;
+    if (choiceNum === targets.length + 1) {
+        selectedTargets = targets;
+    }
+    else if (choiceNum >= 1 && choiceNum <= targets.length) {
+        selectedTargets = [targets[choiceNum - 1]];
+    }
+    else {
+        console.log('\n  Invalid choice. Setup cancelled.');
+        rl.close();
+        process.exit(1);
+    }
+    // Write config
+    const entry = { ...MCP_ENTRY, env: { AITABLES_API_KEY: apiKey } };
+    for (const target of selectedTargets) {
+        const config = readJsonFile(target.path);
+        if (!config[target.wrapperKey]) {
+            config[target.wrapperKey] = {};
+        }
+        config[target.wrapperKey].aitables = entry;
+        writeJsonFile(target.path, config);
+        console.log(`  ✓ Configured ${target.name}`);
+        console.log(`    ${target.path}`);
+    }
+    console.log('');
+    console.log('  ✅ Setup complete! Restart Claude to start using AiTables.');
+    console.log('');
+    console.log('  Try asking Claude:');
+    console.log('    "What databases do I have?"');
+    console.log('    "Show me the tables in my project tracker"');
+    console.log('    "Create a new task tracker with Status, Priority, and Due Date"');
+    console.log('');
+    rl.close();
+}
+run().catch((err) => {
+    console.error('Setup failed:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AiTablesClient } from '../api-client.js';
+export declare function registerCommentTools(server: McpServer, client: AiTablesClient): void;
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,QAkF7E"}