@tenonhq/dovetail-mcp 0.0.45 → 0.0.47

package/README.md

@@ -69,12 +69,20 @@ clear "not configured" error.
 | `calendar_get_today`            | Today's events                                 |
 | `calendar_get_week`             | Next 7 days                                    |
 | `calendar_get_event`            | Single event by ID                             |
-| `servicenow_query_table`        | Table API GET (deny-listed tables blocked)     |
+| `servicenow_query_table`        | Table API GET — `table`, `sysparm_query`, optional `fields[]`, `limit` (≤1000), `offset`, `env` (deny-listed tables blocked) |
 
 ServiceNow deny-list (default): `sys_user_password`, `sys_user_token`,
 `sys_credential`, `sys_secret`, `sys_user_grmember`, `sys_audit`. Override
 per-table with `SINC_MCP_SN_TABLE_OVERRIDE=table_a,table_b`.
 
+**Paging past 1000 rows.** The Table API caps a single page at 1000 rows and
+`limit` is capped to match, so a larger result set is read page by page with
+`offset` (→ `sysparm_offset`): keep `sysparm_query` and `limit` fixed and
+request `offset = page * limit` for page 0, 1, 2, …; the last page is the first
+one that returns fewer than `limit` rows. Add `ORDERBYsys_id` to the query so
+the pages don't shift between calls. `offset` is omitted from the request when
+not supplied.
+
 🔒 **Gated writes (Phase 2).** The four ClickUp write tools are inert unless
 `SINC_MCP_WRITES_ENABLE=1` is set — that's the operator-controlled gate. When
 on, calls return a dry-run preview unless `confirm:true` is passed; the

package/dist/registry.js

@@ -191,7 +191,7 @@ function buildDescriptors(deps) {
         },
         {
             name: "servicenow_query_table",
-            description: "Read-only GET against the ServiceNow Table API. Required: table (lower-case identifier), sysparm_query (ServiceNow encoded query). Optional: fields[] limits the columns returned, limit caps row count (default 100, max 1000), env retargets a single call to a different instance by naming an env file in the server's working directory ('prod' or '.env.prod' → reads creds from .env.prod; omit to use the startup instance). Tables on the deny list (sys_user_password, sys_credential, etc.) are rejected unless SINC_MCP_SN_TABLE_OVERRIDE=<table> is set.",
+            description: "Read-only GET against the ServiceNow Table API. Required: table (lower-case identifier), sysparm_query (ServiceNow encoded query). Optional: fields[] limits the columns returned, limit caps row count (default 100, max 1000 — the instance's hard per-page ceiling), offset skips rows (sysparm_offset, default 0) so result sets larger than 1000 rows can be paged: page N (0-based) is offset = N * limit with the same limit and query, and the last page is the first one that returns fewer than limit rows (add ORDERBYsys_id to the query for a stable order), env retargets a single call to a different instance by naming an env file in the server's working directory ('prod' or '.env.prod' → reads creds from .env.prod; omit to use the startup instance). Tables on the deny list (sys_user_password, sys_credential, etc.) are rejected unless SINC_MCP_SN_TABLE_OVERRIDE=<table> is set.",
             shape: servicenow_1.servicenowQueryTableSchema.shape,
             annotations: dovetail_mcp_kit_1.READ_ONLY,
             handler: function (args) {

package/dist/schemas/servicenow.d.ts

@@ -4,16 +4,19 @@ export declare var servicenowQueryTableSchema: z.ZodObject<{
     sysparm_query: z.ZodString;
     fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
     env: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     table: string;
     sysparm_query: string;
+    offset?: number | undefined;
     fields?: string[] | undefined;
     limit?: number | undefined;
     env?: string | undefined;
 }, {
     table: string;
     sysparm_query: string;
+    offset?: number | undefined;
     fields?: string[] | undefined;
     limit?: number | undefined;
     env?: string | undefined;

package/dist/schemas/servicenow.js

@@ -7,6 +7,9 @@ exports.servicenowQueryTableSchema = zod_1.z.object({
     sysparm_query: zod_1.z.string(),
     fields: zod_1.z.array(zod_1.z.string().min(1)).optional(),
     limit: zod_1.z.number().int().min(1).max(1000).optional(),
+    // Row offset → sysparm_offset. The Table API caps one page at 1000 rows, so
+    // paging past that is offset = page * limit (0-based pages). Omit → not sent.
+    offset: zod_1.z.number().int().min(0).optional(),
     // Optional per-call instance retarget. Names an env file in the server's
     // working directory: a bare token like "prod" or "workshop" resolves to
     // ".env.<token>", or pass the full ".env.<name>" basename. Path separators

package/dist/tools/servicenow.js

@@ -64,12 +64,20 @@ async function servicenowQueryTable(args, deps) {
     }
     var client = resolveClient(deps, args.env);
     var limit = args.limit !== undefined ? args.limit : 100;
+    var hasFields = Boolean(args.fields && args.fields.length > 0);
+    var hasOffset = args.offset !== undefined;
     var records;
-    if (args.fields && args.fields.length > 0) {
-        records = await client.table.query(args.table, args.sysparm_query, {
-            limit: limit,
-            fields: args.fields
-        });
+    if (hasFields || hasOffset) {
+        // Options-object form: fields and/or offset. offset maps to sysparm_offset
+        // inside the client; when omitted it is never sent (instance default 0).
+        var options = { limit: limit };
+        if (hasFields) {
+            options.fields = args.fields;
+        }
+        if (hasOffset) {
+            options.offset = args.offset;
+        }
+        records = await client.table.query(args.table, args.sysparm_query, options);
     }
     else {
         records = await client.table.query(args.table, args.sysparm_query, limit);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenonhq/dovetail-mcp",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "description": "MCP server exposing read tools for ClickUp / Gmail / Calendar / ServiceNow plus gated ClickUp writes, backed by the Dovetail integration packages.",
   "main": "./dist/index.js",
   "bin": {
@@ -22,7 +22,7 @@
     "@tenonhq/dovetail-google-auth": "~0.0.12",
     "@tenonhq/dovetail-google-calendar": "~0.0.11",
     "@tenonhq/dovetail-mcp-kit": "~0.0.1",
-    "@tenonhq/dovetail-servicenow": "~0.0.47",
+    "@tenonhq/dovetail-servicenow": "~0.0.49",
     "dotenv": "^16.3.1",
     "zod": "^3.23.0"
   },