gearvn-pages-mcp-server 1.7.0 → 1.9.0

package/dist/index.js

@@ -30,7 +30,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             return await handleDeployPage(args);
         }
         else if (name === "list-pages") {
-            return await handleListPages();
+            return await handleListPages(args);
         }
         else if (name === "get-page") {
             return await handleGetPage(args);

package/dist/index.js.map

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

package/dist/tools/deploy-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-page.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,gBAAgB,EAAE,IAmC9B,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO;;;;;GA8CnD"}
+{"version":3,"file":"deploy-page.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,gBAAgB,EAAE,IAwC9B,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO;;;;;GAoDnD"}

package/dist/tools/deploy-page.js

@@ -26,12 +26,16 @@ export const DEPLOY_PAGE_TOOL = {
                 },
                 description: "Optional array of tags to categorize the page (e.g., ['dashboard', 'finance']). Tags are case-insensitive for filtering.",
             },
+            metadata: {
+                type: "object",
+                description: "Optional key-value metadata to store with the page. Can contain any JSON structure (strings, numbers, arrays, nested objects). Useful for storing additional information like author/owner, category/classification, related resources, or custom attributes for filtering. Example: { \"vendor\": \"Apple\", \"category\": \"product\", \"attendees\": [\"John\", \"Jane\"] }. This metadata is searchable via list-pages tool.",
+            },
         },
         required: ["title", "content", "slug"],
     },
 };
 export async function handleDeployPage(args) {
-    const { title, content, slug, tags } = args;
+    const { title, content, slug, tags, metadata } = args;
     // Validate inputs
     if (!title || !content || !slug) {
         throw new Error("Missing required parameters: title, content, and slug are required");
@@ -46,6 +50,10 @@ export async function handleDeployPage(args) {
     if (tags && tags.length > 0) {
         requestBody.tags = tags;
     }
+    // Add metadata if provided
+    if (metadata && Object.keys(metadata).length > 0) {
+        requestBody.metadata = metadata;
+    }
     // Call the deploy API
     const response = await callAPI("/v1/deploy", "POST", requestBody);
     return {
@@ -57,6 +65,7 @@ export async function handleDeployPage(args) {
                     message: "Page deployed successfully",
                     url: response.url,
                     tags: tags || [],
+                    metadata: metadata || {},
                 }, null, 2),
             },
         ],

package/dist/tools/deploy-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-page.js","sourceRoot":"","sources":["../../src/tools/deploy-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,6sBAA6sB;IAC/sB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6FAA6F;aAChG;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,ypBAAypB;aAC5pB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iDAAiD;oBACjD,8EAA8E;oBAC9E,2IAA2I;aAC9I;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EACT,0HAA0H;aAC7H;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;KACvC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAa;IAClD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAsB,CAAC;IAE9D,kBAAkB;IAClB,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,WAAW,GAAmB;QAClC,KAAK;QACL,OAAO;QACP,IAAI;KACL,CAAC;IAEF,uBAAuB;IACvB,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,YAAY,EACZ,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,4BAA4B;oBACrC,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,IAAI,EAAE,IAAI,IAAI,EAAE;iBACjB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"deploy-page.js","sourceRoot":"","sources":["../../src/tools/deploy-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,6sBAA6sB;IAC/sB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6FAA6F;aAChG;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,ypBAAypB;aAC5pB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iDAAiD;oBACjD,8EAA8E;oBAC9E,2IAA2I;aAC9I;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EACT,0HAA0H;aAC7H;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kaAAka;aACra;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;KACvC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAa;IAClD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAsB,CAAC;IAExE,kBAAkB;IAClB,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,WAAW,GAAmB;QAClC,KAAK;QACL,OAAO;QACP,IAAI;KACL,CAAC;IAEF,uBAAuB;IACvB,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,2BAA2B;IAC3B,IAAI,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,YAAY,EACZ,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,4BAA4B;oBACrC,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,IAAI,EAAE,IAAI,IAAI,EAAE;oBAChB,QAAQ,EAAE,QAAQ,IAAI,EAAE;iBACzB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-page.d.ts","sourceRoot":"","sources":["../../src/tools/get-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,aAAa,EAAE,IAe3B,CAAC;AAEF,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO;;;;;GA4BhD"}
+{"version":3,"file":"get-page.d.ts","sourceRoot":"","sources":["../../src/tools/get-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,aAAa,EAAE,IA+C3B,CAAC;AAEF,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO;;;;;GAuChD"}

package/dist/tools/get-page.js

@@ -1,7 +1,24 @@
 import { callAPI } from "../api.js";
 export const GET_PAGE_TOOL = {
     name: "get-page",
-    description: "Get the full content of a page by its slug. Returns the complete page data including HTML content, title, and tags. Use the exact slug from list-pages response (including timestamp suffix).",
+    description: `Get the full content of a page by its slug.
+
+CONTENT FORMAT:
+- By default, returns HTML content
+- md=true: Returns content converted to Markdown (useful for AI processing)
+
+METADATA CONTROL:
+- By default, metadata only returns keys with empty values (to reduce payload)
+- metafull=true: Returns full metadata with all values
+- metafields=["key1","key2"]: Returns values only for specified keys
+
+EXAMPLES:
+1. Get page HTML: get-page with slug="my-page-123456"
+2. Get page as Markdown: get-page with slug="my-page-123456", md=true
+3. Get page with full metadata: get-page with slug="my-page-123456", metafull=true
+4. Get page with specific metadata: get-page with slug="my-page-123456", metafields=["risks","actions"]
+
+Returns: Page data with id, slug, title, content (HTML or Markdown), tags, and metadata.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -9,18 +26,42 @@ export const GET_PAGE_TOOL = {
                 type: "string",
                 description: "The exact slug of the page to retrieve (must match the slug from list-pages response, including timestamp suffix)",
             },
+            md: {
+                type: "boolean",
+                description: "Set to true to return content as Markdown instead of HTML. Useful for AI processing.",
+            },
+            metafull: {
+                type: "boolean",
+                description: "Set to true to return full metadata with all values. By default, metadata only returns keys with empty values.",
+            },
+            metafields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Array of metadata keys to return with full values. E.g., ['risks', 'actions'] returns only these keys with values.",
+            },
         },
         required: ["slug"],
     },
 };
 export async function handleGetPage(args) {
-    const { slug } = args;
+    const { slug, md, metafull, metafields } = args;
     // Validate inputs
     if (!slug) {
         throw new Error("Missing required parameter: slug is required");
     }
+    // Build query parameters
+    const params = new URLSearchParams();
+    if (md)
+        params.append("md", "1");
+    if (metafull)
+        params.append("metafull", "1");
+    if (metafields && metafields.length > 0) {
+        params.append("metafields", `[${metafields.join(",")}]`);
+    }
+    const queryString = params.toString();
+    const endpoint = queryString ? `/v1/get-page?${queryString}` : "/v1/get-page";
     // Call the get-page API
-    const response = await callAPI("/v1/get-page", "POST", {
+    const response = await callAPI(endpoint, "POST", {
         slug,
     });
     return {

package/dist/tools/get-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-page.js","sourceRoot":"","sources":["../../src/tools/get-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,+LAA+L;IACjM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mHAAmH;aACtH;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAa;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAmB,CAAC;IAErC,kBAAkB;IAClB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAkB,cAAc,EAAE,MAAM,EAAE;QACtE,IAAI;KACL,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE,QAAQ;iBACf,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-page.js","sourceRoot":"","sources":["../../src/tools/get-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE;;;;;;;;;;;;;;;;;yFAiB0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mHAAmH;aACtH;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,sFAAsF;aACzF;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,gHAAgH;aACnH;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,oHAAoH;aACvH;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAa;IAC/C,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAmB,CAAC;IAE/D,kBAAkB;IAClB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,EAAE;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ;QAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAE9E,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAkB,QAAQ,EAAE,MAAM,EAAE;QAChE,IAAI;KACL,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE,QAAQ;iBACf,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-pages.d.ts

@@ -1,6 +1,6 @@
 import { Tool } from "@modelcontextprotocol/sdk/types.js";
 export declare const LIST_PAGES_TOOL: Tool;
-export declare function handleListPages(): Promise<{
+export declare function handleListPages(args?: unknown): Promise<{
     content: {
         type: "text";
         text: string;

package/dist/tools/list-pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-pages.d.ts","sourceRoot":"","sources":["../../src/tools/list-pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,eAAe,EAAE,IAQ7B,CAAC;AAEF,wBAAsB,eAAe;;;;;GAoBpC"}
+{"version":3,"file":"list-pages.d.ts","sourceRoot":"","sources":["../../src/tools/list-pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,eAAe,EAAE,IA+E7B,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO;;;;;GAyCnD"}

package/dist/tools/list-pages.js

@@ -1,22 +1,112 @@
 import { callAPI } from "../api.js";
 export const LIST_PAGES_TOOL = {
     name: "list-pages",
-    description: "List all pages associated with your API key. Returns a summary of each page including id, slug, title, url, tags, and timestamps. Does not include page content.",
+    description: `List all deployed pages with optional filtering, search, and pagination.
+
+PAGINATION:
+- page: Page number (default: 1)
+- limit: Items per page (default: 50)
+
+FILTERING OPTIONS:
+- Filter by tag: Use 'tags' parameter to find pages with a specific tag
+- Search across fields: Use 'search' parameter to find pages containing the search term
+
+SEARCH BEHAVIOR:
+- Without 'key': Searches across ALL fields (title, slug, tags, and metadata values)
+- With 'key': Searches only in the specified field
+  - key="title": Search in page title only
+  - key="slug": Search in page slug only
+  - key="tags": Search in tags array only
+  - key="metadata": Search in metadata values (all nested levels)
+- With 'key=metadata' + 'metadata_key': Search in a specific metadata field only
+
+METADATA CONTROL:
+- By default, metadata only returns keys with empty values (to reduce payload)
+- metafull=true: Returns full metadata with all values
+- metafields=["key1","key2"]: Returns values only for specified keys
+
+EXAMPLES:
+1. Find all pages: list-pages (no params)
+2. Paginate: list-pages with page=2, limit=10
+3. Find pages tagged "marketing": list-pages with tags="marketing"
+4. Find pages with full metadata: list-pages with metafull=true
+5. Find pages with specific metadata: list-pages with metafields=["risks","actions"]
+
+Returns: Paginated response with total, page, limit, and array of page summaries.`,
     inputSchema: {
         type: "object",
-        properties: {},
+        properties: {
+            page: {
+                type: "number",
+                description: "Page number for pagination (default: 1)",
+            },
+            limit: {
+                type: "number",
+                description: "Number of items per page (default: 50)",
+            },
+            tags: {
+                type: "string",
+                description: "Filter by exact tag match (case-insensitive). Returns pages that have this tag.",
+            },
+            search: {
+                type: "string",
+                description: "Search term to find pages. Case-insensitive partial match. Without 'key' param, searches across title, slug, tags, and all metadata values.",
+            },
+            key: {
+                type: "string",
+                enum: ["title", "tags", "slug", "metadata"],
+                description: "Specify which field to search in. Only used with 'search' param. If omitted, searches all fields.",
+            },
+            metadata_key: {
+                type: "string",
+                description: "When key='metadata', specify a specific metadata field to search in. E.g., 'vendor' to search only in metadata.vendor",
+            },
+            metafull: {
+                type: "boolean",
+                description: "Set to true to return full metadata with all values. By default, metadata only returns keys with empty values.",
+            },
+            metafields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Array of metadata keys to return with full values. E.g., ['risks', 'actions'] returns only these keys with values.",
+            },
+        },
     },
 };
-export async function handleListPages() {
+export async function handleListPages(args) {
+    const { tags, search, key, metadata_key, page, limit, metafull, metafields } = args || {};
+    // Build query parameters
+    const params = new URLSearchParams();
+    if (tags)
+        params.append("tags", tags);
+    if (search)
+        params.append("search", search);
+    if (key)
+        params.append("key", key);
+    if (metadata_key)
+        params.append("metadata_key", metadata_key);
+    if (page)
+        params.append("page", page.toString());
+    if (limit)
+        params.append("limit", limit.toString());
+    if (metafull)
+        params.append("metafull", "1");
+    if (metafields && metafields.length > 0) {
+        params.append("metafields", `[${metafields.join(",")}]`);
+    }
+    const queryString = params.toString();
+    const endpoint = queryString ? `/v1/pages?${queryString}` : "/v1/pages";
     // Call the list pages API
-    const response = await callAPI("/v1/pages", "GET");
+    const response = await callAPI(endpoint, "GET");
     return {
         content: [
             {
                 type: "text",
                 text: JSON.stringify({
                     success: true,
-                    count: response.count,
+                    total: response.total,
+                    page: response.page,
+                    limit: response.limit,
                     pages: response.pages,
                 }, null, 2),
             },

package/dist/tools/list-pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-pages.js","sourceRoot":"","sources":["../../src/tools/list-pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kKAAkK;IACpK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAoB,WAAW,EAAE,KAAK,CAAC,CAAC;IAEtE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;iBACtB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"list-pages.js","sourceRoot":"","sources":["../../src/tools/list-pages.ts"],"names":[],"mappings":"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"}

package/dist/tools/update-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-page.d.ts","sourceRoot":"","sources":["../../src/tools/update-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,gBAAgB,EAAE,IAgC9B,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO;;;;;GAqDnD"}
+{"version":3,"file":"update-page.d.ts","sourceRoot":"","sources":["../../src/tools/update-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,gBAAgB,EAAE,IAqC9B,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO;;;;;GAyDnD"}

package/dist/tools/update-page.js

@@ -1,7 +1,7 @@
 import { callAPI } from "../api.js";
 export const UPDATE_PAGE_TOOL = {
     name: "update-page",
-    description: "Update an existing page by slug. You can update title, content, or tags individually or in combination. IMPORTANT: You must use the EXACT slug from list-pages response, including the timestamp suffix (e.g., 'my-page-1730229600'). At least one field (title, content, or tags) must be provided for update.",
+    description: "Update an existing page by slug. You can update title, content, tags, or metadata individually or in combination. IMPORTANT: You must use the EXACT slug from list-pages response, including the timestamp suffix (e.g., 'my-page-1730229600'). At least one field (title, content, tags, or metadata) must be provided for update.",
     inputSchema: {
         type: "object",
         properties: {
@@ -24,19 +24,24 @@ export const UPDATE_PAGE_TOOL = {
                 },
                 description: "Optional new array of tags to categorize the page (e.g., ['dashboard', 'finance']). This will replace existing tags. Tags are case-insensitive for filtering.",
             },
+            metadata: {
+                type: "object",
+                description: "New metadata object to replace existing metadata. Note: This REPLACES the entire metadata object, not merges. To add a field, include all existing fields plus the new one. To remove a field, include all fields except the one to remove. Pass empty object {} to clear all metadata.",
+            },
         },
         required: ["slug"],
     },
 };
 export async function handleUpdatePage(args) {
-    const { slug, title, content, tags } = args;
+    const { slug, title, content, tags, metadata } = args;
     // Validate inputs
     if (!slug) {
         throw new Error("Missing required parameter: slug is required");
     }
     // Check if at least one field is provided
-    if (!title && !content && (!tags || tags.length === 0)) {
-        throw new Error("At least one field (title, content, or tags) must be provided for update");
+    const hasMetadata = metadata && Object.keys(metadata).length > 0;
+    if (!title && !content && (!tags || tags.length === 0) && !hasMetadata) {
+        throw new Error("At least one field (title, content, tags, or metadata) must be provided for update");
     }
     // Build request body
     const requestBody = {
@@ -51,6 +56,9 @@ export async function handleUpdatePage(args) {
     if (tags && tags.length > 0) {
         requestBody.tags = tags;
     }
+    if (hasMetadata) {
+        requestBody.metadata = metadata;
+    }
     // Call the update API
     const response = await callAPI("/v1/pages", "PUT", requestBody);
     return {

package/dist/tools/update-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-page.js","sourceRoot":"","sources":["../../src/tools/update-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,iTAAiT;IACnT,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iHAAiH;aACpH;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6GAA6G;aAChH;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EACT,+JAA+J;aAClK;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAa;IAClD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAsB,CAAC;IAE9D,kBAAkB;IAClB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,WAAW,GAAmB;QAClC,IAAI;KACL,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,WAAW,EACX,KAAK,EACL,WAAW,CACZ,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;iBACpB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"update-page.js","sourceRoot":"","sources":["../../src/tools/update-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,qUAAqU;IACvU,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iHAAiH;aACpH;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6GAA6G;aAChH;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EACT,+JAA+J;aAClK;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yRAAyR;aAC5R;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAa;IAClD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAsB,CAAC;IAExE,kBAAkB;IAClB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,0CAA0C;IAC1C,MAAM,WAAW,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,WAAW,GAAmB;QAClC,IAAI;KACL,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1B,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,WAAW,EACX,KAAK,EACL,WAAW,CACZ,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;iBACpB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -3,6 +3,7 @@ export interface DeployPageArgs {
     content: string;
     slug: string;
     tags?: string[];
+    metadata?: Record<string, unknown>;
 }
 export interface DeployPageResponse {
     url: string;
@@ -13,11 +14,14 @@ export interface PageSummary {
     title: string;
     url: string;
     tags?: string[];
+    metadata?: Record<string, unknown>;
     created_at: string;
     updated_at: string;
 }
 export interface ListPagesResponse {
-    count: number;
+    total: number;
+    page: number;
+    limit: number;
     pages: PageSummary[];
 }
 export interface UpdatePageArgs {
@@ -25,6 +29,7 @@ export interface UpdatePageArgs {
     title?: string;
     content?: string;
     tags?: string[];
+    metadata?: Record<string, unknown>;
 }
 export interface UpdatePageResponse {
     message: string;
@@ -38,6 +43,9 @@ export interface DeletePageResponse {
 }
 export interface GetPageArgs {
     slug: string;
+    metafull?: boolean;
+    metafields?: string[];
+    md?: boolean;
 }
 export interface GetPageResponse {
     id: number;
@@ -45,5 +53,16 @@ export interface GetPageResponse {
     title: string;
     content: string;
     tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface ListPagesArgs {
+    tags?: string;
+    search?: string;
+    key?: "title" | "tags" | "slug" | "metadata";
+    metadata_key?: string;
+    page?: number;
+    limit?: number;
+    metafull?: boolean;
+    metafields?: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gearvn-pages-mcp-server",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "MCP Server for GearVN Pages deployment and management",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -40,7 +40,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     if (name === "deploy-page") {
       return await handleDeployPage(args);
     } else if (name === "list-pages") {
-      return await handleListPages();
+      return await handleListPages(args);
     } else if (name === "get-page") {
       return await handleGetPage(args);
     } else if (name === "update-page") {

package/src/tools/deploy-page.ts

@@ -34,13 +34,18 @@ export const DEPLOY_PAGE_TOOL: Tool = {
         description:
           "Optional array of tags to categorize the page (e.g., ['dashboard', 'finance']). Tags are case-insensitive for filtering.",
       },
+      metadata: {
+        type: "object",
+        description:
+          "Optional key-value metadata to store with the page. Can contain any JSON structure (strings, numbers, arrays, nested objects). Useful for storing additional information like author/owner, category/classification, related resources, or custom attributes for filtering. Example: { \"vendor\": \"Apple\", \"category\": \"product\", \"attendees\": [\"John\", \"Jane\"] }. This metadata is searchable via list-pages tool.",
+      },
     },
     required: ["title", "content", "slug"],
   },
 };
 
 export async function handleDeployPage(args: unknown) {
-  const { title, content, slug, tags } = args as DeployPageArgs;
+  const { title, content, slug, tags, metadata } = args as DeployPageArgs;
 
   // Validate inputs
   if (!title || !content || !slug) {
@@ -61,6 +66,11 @@ export async function handleDeployPage(args: unknown) {
     requestBody.tags = tags;
   }
 
+  // Add metadata if provided
+  if (metadata && Object.keys(metadata).length > 0) {
+    requestBody.metadata = metadata;
+  }
+
   // Call the deploy API
   const response = await callAPI<DeployPageResponse>(
     "/v1/deploy",
@@ -78,6 +88,7 @@ export async function handleDeployPage(args: unknown) {
             message: "Page deployed successfully",
             url: response.url,
             tags: tags || [],
+            metadata: metadata || {},
           },
           null,
           2

package/src/tools/get-page.ts

@@ -4,8 +4,24 @@ import { GetPageArgs, GetPageResponse } from "../types.js";
 
 export const GET_PAGE_TOOL: Tool = {
   name: "get-page",
-  description:
-    "Get the full content of a page by its slug. Returns the complete page data including HTML content, title, and tags. Use the exact slug from list-pages response (including timestamp suffix).",
+  description: `Get the full content of a page by its slug.
+
+CONTENT FORMAT:
+- By default, returns HTML content
+- md=true: Returns content converted to Markdown (useful for AI processing)
+
+METADATA CONTROL:
+- By default, metadata only returns keys with empty values (to reduce payload)
+- metafull=true: Returns full metadata with all values
+- metafields=["key1","key2"]: Returns values only for specified keys
+
+EXAMPLES:
+1. Get page HTML: get-page with slug="my-page-123456"
+2. Get page as Markdown: get-page with slug="my-page-123456", md=true
+3. Get page with full metadata: get-page with slug="my-page-123456", metafull=true
+4. Get page with specific metadata: get-page with slug="my-page-123456", metafields=["risks","actions"]
+
+Returns: Page data with id, slug, title, content (HTML or Markdown), tags, and metadata.`,
   inputSchema: {
     type: "object",
     properties: {
@@ -14,21 +30,48 @@ export const GET_PAGE_TOOL: Tool = {
         description:
           "The exact slug of the page to retrieve (must match the slug from list-pages response, including timestamp suffix)",
       },
+      md: {
+        type: "boolean",
+        description:
+          "Set to true to return content as Markdown instead of HTML. Useful for AI processing.",
+      },
+      metafull: {
+        type: "boolean",
+        description:
+          "Set to true to return full metadata with all values. By default, metadata only returns keys with empty values.",
+      },
+      metafields: {
+        type: "array",
+        items: { type: "string" },
+        description:
+          "Array of metadata keys to return with full values. E.g., ['risks', 'actions'] returns only these keys with values.",
+      },
     },
     required: ["slug"],
   },
 };
 
 export async function handleGetPage(args: unknown) {
-  const { slug } = args as GetPageArgs;
+  const { slug, md, metafull, metafields } = args as GetPageArgs;
 
   // Validate inputs
   if (!slug) {
     throw new Error("Missing required parameter: slug is required");
   }
 
+  // Build query parameters
+  const params = new URLSearchParams();
+  if (md) params.append("md", "1");
+  if (metafull) params.append("metafull", "1");
+  if (metafields && metafields.length > 0) {
+    params.append("metafields", `[${metafields.join(",")}]`);
+  }
+
+  const queryString = params.toString();
+  const endpoint = queryString ? `/v1/get-page?${queryString}` : "/v1/get-page";
+
   // Call the get-page API
-  const response = await callAPI<GetPageResponse>("/v1/get-page", "POST", {
+  const response = await callAPI<GetPageResponse>(endpoint, "POST", {
     slug,
   });
 

package/src/tools/list-pages.ts

@@ -1,20 +1,110 @@
 import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import { callAPI } from "../api.js";
-import { ListPagesResponse } from "../types.js";
+import { ListPagesArgs, ListPagesResponse } from "../types.js";
 
 export const LIST_PAGES_TOOL: Tool = {
   name: "list-pages",
-  description:
-    "List all pages associated with your API key. Returns a summary of each page including id, slug, title, url, tags, and timestamps. Does not include page content.",
+  description: `List all deployed pages with optional filtering, search, and pagination.
+
+PAGINATION:
+- page: Page number (default: 1)
+- limit: Items per page (default: 50)
+
+FILTERING OPTIONS:
+- Filter by tag: Use 'tags' parameter to find pages with a specific tag
+- Search across fields: Use 'search' parameter to find pages containing the search term
+
+SEARCH BEHAVIOR:
+- Without 'key': Searches across ALL fields (title, slug, tags, and metadata values)
+- With 'key': Searches only in the specified field
+  - key="title": Search in page title only
+  - key="slug": Search in page slug only
+  - key="tags": Search in tags array only
+  - key="metadata": Search in metadata values (all nested levels)
+- With 'key=metadata' + 'metadata_key': Search in a specific metadata field only
+
+METADATA CONTROL:
+- By default, metadata only returns keys with empty values (to reduce payload)
+- metafull=true: Returns full metadata with all values
+- metafields=["key1","key2"]: Returns values only for specified keys
+
+EXAMPLES:
+1. Find all pages: list-pages (no params)
+2. Paginate: list-pages with page=2, limit=10
+3. Find pages tagged "marketing": list-pages with tags="marketing"
+4. Find pages with full metadata: list-pages with metafull=true
+5. Find pages with specific metadata: list-pages with metafields=["risks","actions"]
+
+Returns: Paginated response with total, page, limit, and array of page summaries.`,
   inputSchema: {
     type: "object",
-    properties: {},
+    properties: {
+      page: {
+        type: "number",
+        description: "Page number for pagination (default: 1)",
+      },
+      limit: {
+        type: "number",
+        description: "Number of items per page (default: 50)",
+      },
+      tags: {
+        type: "string",
+        description:
+          "Filter by exact tag match (case-insensitive). Returns pages that have this tag.",
+      },
+      search: {
+        type: "string",
+        description:
+          "Search term to find pages. Case-insensitive partial match. Without 'key' param, searches across title, slug, tags, and all metadata values.",
+      },
+      key: {
+        type: "string",
+        enum: ["title", "tags", "slug", "metadata"],
+        description:
+          "Specify which field to search in. Only used with 'search' param. If omitted, searches all fields.",
+      },
+      metadata_key: {
+        type: "string",
+        description:
+          "When key='metadata', specify a specific metadata field to search in. E.g., 'vendor' to search only in metadata.vendor",
+      },
+      metafull: {
+        type: "boolean",
+        description:
+          "Set to true to return full metadata with all values. By default, metadata only returns keys with empty values.",
+      },
+      metafields: {
+        type: "array",
+        items: { type: "string" },
+        description:
+          "Array of metadata keys to return with full values. E.g., ['risks', 'actions'] returns only these keys with values.",
+      },
+    },
   },
 };
 
-export async function handleListPages() {
+export async function handleListPages(args?: unknown) {
+  const { tags, search, key, metadata_key, page, limit, metafull, metafields } =
+    (args as ListPagesArgs) || {};
+
+  // Build query parameters
+  const params = new URLSearchParams();
+  if (tags) params.append("tags", tags);
+  if (search) params.append("search", search);
+  if (key) params.append("key", key);
+  if (metadata_key) params.append("metadata_key", metadata_key);
+  if (page) params.append("page", page.toString());
+  if (limit) params.append("limit", limit.toString());
+  if (metafull) params.append("metafull", "1");
+  if (metafields && metafields.length > 0) {
+    params.append("metafields", `[${metafields.join(",")}]`);
+  }
+
+  const queryString = params.toString();
+  const endpoint = queryString ? `/v1/pages?${queryString}` : "/v1/pages";
+
   // Call the list pages API
-  const response = await callAPI<ListPagesResponse>("/v1/pages", "GET");
+  const response = await callAPI<ListPagesResponse>(endpoint, "GET");
 
   return {
     content: [
@@ -23,7 +113,9 @@ export async function handleListPages() {
         text: JSON.stringify(
           {
             success: true,
-            count: response.count,
+            total: response.total,
+            page: response.page,
+            limit: response.limit,
             pages: response.pages,
           },
           null,

package/src/tools/update-page.ts

@@ -5,7 +5,7 @@ import { UpdatePageArgs, UpdatePageResponse } from "../types.js";
 export const UPDATE_PAGE_TOOL: Tool = {
   name: "update-page",
   description:
-    "Update an existing page by slug. You can update title, content, or tags individually or in combination. IMPORTANT: You must use the EXACT slug from list-pages response, including the timestamp suffix (e.g., 'my-page-1730229600'). At least one field (title, content, or tags) must be provided for update.",
+    "Update an existing page by slug. You can update title, content, tags, or metadata individually or in combination. IMPORTANT: You must use the EXACT slug from list-pages response, including the timestamp suffix (e.g., 'my-page-1730229600'). At least one field (title, content, tags, or metadata) must be provided for update.",
   inputSchema: {
     type: "object",
     properties: {
@@ -31,13 +31,18 @@ export const UPDATE_PAGE_TOOL: Tool = {
         description:
           "Optional new array of tags to categorize the page (e.g., ['dashboard', 'finance']). This will replace existing tags. Tags are case-insensitive for filtering.",
       },
+      metadata: {
+        type: "object",
+        description:
+          "New metadata object to replace existing metadata. Note: This REPLACES the entire metadata object, not merges. To add a field, include all existing fields plus the new one. To remove a field, include all fields except the one to remove. Pass empty object {} to clear all metadata.",
+      },
     },
     required: ["slug"],
   },
 };
 
 export async function handleUpdatePage(args: unknown) {
-  const { slug, title, content, tags } = args as UpdatePageArgs;
+  const { slug, title, content, tags, metadata } = args as UpdatePageArgs;
 
   // Validate inputs
   if (!slug) {
@@ -45,9 +50,10 @@ export async function handleUpdatePage(args: unknown) {
   }
 
   // Check if at least one field is provided
-  if (!title && !content && (!tags || tags.length === 0)) {
+  const hasMetadata = metadata && Object.keys(metadata).length > 0;
+  if (!title && !content && (!tags || tags.length === 0) && !hasMetadata) {
     throw new Error(
-      "At least one field (title, content, or tags) must be provided for update"
+      "At least one field (title, content, tags, or metadata) must be provided for update"
     );
   }
 
@@ -65,6 +71,9 @@ export async function handleUpdatePage(args: unknown) {
   if (tags && tags.length > 0) {
     requestBody.tags = tags;
   }
+  if (hasMetadata) {
+    requestBody.metadata = metadata;
+  }
 
   // Call the update API
   const response = await callAPI<UpdatePageResponse>(

package/src/types.ts

@@ -3,6 +3,7 @@ export interface DeployPageArgs {
   content: string;
   slug: string;
   tags?: string[];
+  metadata?: Record<string, unknown>;
 }
 
 export interface DeployPageResponse {
@@ -15,12 +16,15 @@ export interface PageSummary {
   title: string;
   url: string;
   tags?: string[];
+  metadata?: Record<string, unknown>;
   created_at: string;
   updated_at: string;
 }
 
 export interface ListPagesResponse {
-  count: number;
+  total: number;
+  page: number;
+  limit: number;
   pages: PageSummary[];
 }
 
@@ -29,6 +33,7 @@ export interface UpdatePageArgs {
   title?: string;
   content?: string;
   tags?: string[];
+  metadata?: Record<string, unknown>;
 }
 
 export interface UpdatePageResponse {
@@ -46,6 +51,9 @@ export interface DeletePageResponse {
 
 export interface GetPageArgs {
   slug: string;
+  metafull?: boolean;
+  metafields?: string[];
+  md?: boolean;
 }
 
 export interface GetPageResponse {
@@ -54,4 +62,16 @@ export interface GetPageResponse {
   title: string;
   content: string;
   tags?: string[];
+  metadata?: Record<string, unknown>;
+}
+
+export interface ListPagesArgs {
+  tags?: string;
+  search?: string;
+  key?: "title" | "tags" | "slug" | "metadata";
+  metadata_key?: string;
+  page?: number;
+  limit?: number;
+  metafull?: boolean;
+  metafields?: string[];
 }