gearvn-pages-mcp-server 1.6.0 → 1.8.0

package/dist/index.js

@@ -4,6 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { DEPLOY_PAGE_TOOL, handleDeployPage } from "./tools/deploy-page.js";
 import { LIST_PAGES_TOOL, handleListPages } from "./tools/list-pages.js";
+import { GET_PAGE_TOOL, handleGetPage } from "./tools/get-page.js";
 import { UPDATE_PAGE_TOOL, handleUpdatePage } from "./tools/update-page.js";
 import { DELETE_PAGE_TOOL, handleDeletePage } from "./tools/delete-page.js";
 // Create MCP server
@@ -18,7 +19,7 @@ const server = new Server({
 // Handler for listing available tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
-        tools: [DEPLOY_PAGE_TOOL, LIST_PAGES_TOOL, UPDATE_PAGE_TOOL, DELETE_PAGE_TOOL],
+        tools: [DEPLOY_PAGE_TOOL, LIST_PAGES_TOOL, GET_PAGE_TOOL, UPDATE_PAGE_TOOL, DELETE_PAGE_TOOL],
     };
 });
 // Handler for tool calls
@@ -29,7 +30,10 @@ 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);
         }
         else if (name === "update-page") {
             return await handleUpdatePage(args);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,sCAAsC;AACtC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE,CAAC,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;KAC/E,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,yBAAyB;AACzB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAC3B,OAAO,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,MAAM,eAAe,EAAE,CAAC;QACjC,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,OAAO,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,OAAO,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,YAAY;qBACpB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"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

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const GET_PAGE_TOOL: Tool;
+export declare function handleGetPage(args: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-page.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/get-page.js

@@ -0,0 +1,38 @@
+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).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            slug: {
+                type: "string",
+                description: "The exact slug of the page to retrieve (must match the slug from list-pages response, including timestamp suffix)",
+            },
+        },
+        required: ["slug"],
+    },
+};
+export async function handleGetPage(args) {
+    const { slug } = args;
+    // Validate inputs
+    if (!slug) {
+        throw new Error("Missing required parameter: slug is required");
+    }
+    // Call the get-page API
+    const response = await callAPI("/v1/get-page", "POST", {
+        slug,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    page: response,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-page.js.map

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

@@ -0,0 +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"}

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,IAmD7B,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO;;;;;GAgCnD"}

package/dist/tools/list-pages.js

@@ -1,15 +1,68 @@
 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 and search capabilities.
+
+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
+
+EXAMPLES:
+1. Find all pages: list-pages (no params)
+2. Find pages tagged "marketing": list-pages with tags="marketing"
+3. Find pages mentioning "dashboard": list-pages with search="dashboard"
+4. Find pages with "admin" in title: list-pages with search="admin", key="title"
+5. Find pages where vendor is "Apple": list-pages with search="Apple", key="metadata", metadata_key="vendor"
+
+Returns: Array of page summaries (id, slug, title, url, tags, metadata, timestamps). Does not include page content.`,
     inputSchema: {
         type: "object",
-        properties: {},
+        properties: {
+            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",
+            },
+        },
     },
 };
-export async function handleListPages() {
+export async function handleListPages(args) {
+    const { tags, search, key, metadata_key } = 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);
+    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: [
             {

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":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;oHAsBqG;IAClH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iFAAiF;aACpF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6IAA6I;aAChJ;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;gBAC3C,WAAW,EACT,mGAAmG;aACtG;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uHAAuH;aAC1H;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,GAAI,IAAsB,IAAI,EAAE,CAAC;IAE1E,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,GAAG;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnC,IAAI,YAAY;QAAE,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAE9D,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAExE,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAoB,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEnE,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"}

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,6 +14,7 @@ export interface PageSummary {
     title: string;
     url: string;
     tags?: string[];
+    metadata?: Record<string, unknown>;
     created_at: string;
     updated_at: string;
 }
@@ -25,6 +27,7 @@ export interface UpdatePageArgs {
     title?: string;
     content?: string;
     tags?: string[];
+    metadata?: Record<string, unknown>;
 }
 export interface UpdatePageResponse {
     message: string;
@@ -36,4 +39,21 @@ export interface DeletePageArgs {
 export interface DeletePageResponse {
     message: string;
 }
+export interface GetPageArgs {
+    slug: string;
+}
+export interface GetPageResponse {
+    id: number;
+    slug: string;
+    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;
+}
 //# 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"}
+{"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,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;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;CACvB"}

package/package.json

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

package/src/index.ts

@@ -8,6 +8,7 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import { DEPLOY_PAGE_TOOL, handleDeployPage } from "./tools/deploy-page.js";
 import { LIST_PAGES_TOOL, handleListPages } from "./tools/list-pages.js";
+import { GET_PAGE_TOOL, handleGetPage } from "./tools/get-page.js";
 import { UPDATE_PAGE_TOOL, handleUpdatePage } from "./tools/update-page.js";
 import { DELETE_PAGE_TOOL, handleDeletePage } from "./tools/delete-page.js";
 
@@ -27,7 +28,7 @@ const server = new Server(
 // Handler for listing available tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
-    tools: [DEPLOY_PAGE_TOOL, LIST_PAGES_TOOL, UPDATE_PAGE_TOOL, DELETE_PAGE_TOOL],
+    tools: [DEPLOY_PAGE_TOOL, LIST_PAGES_TOOL, GET_PAGE_TOOL, UPDATE_PAGE_TOOL, DELETE_PAGE_TOOL],
   };
 });
 
@@ -39,7 +40,9 @@ 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") {
       return await handleUpdatePage(args);
     } else if (name === "delete-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

@@ -0,0 +1,50 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { callAPI } from "../api.js";
+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).",
+  inputSchema: {
+    type: "object",
+    properties: {
+      slug: {
+        type: "string",
+        description:
+          "The exact slug of the page to retrieve (must match the slug from list-pages response, including timestamp suffix)",
+      },
+    },
+    required: ["slug"],
+  },
+};
+
+export async function handleGetPage(args: unknown) {
+  const { slug } = args as GetPageArgs;
+
+  // Validate inputs
+  if (!slug) {
+    throw new Error("Missing required parameter: slug is required");
+  }
+
+  // Call the get-page API
+  const response = await callAPI<GetPageResponse>("/v1/get-page", "POST", {
+    slug,
+  });
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(
+          {
+            success: true,
+            page: response,
+          },
+          null,
+          2
+        ),
+      },
+    ],
+  };
+}

package/src/tools/list-pages.ts

@@ -1,20 +1,75 @@
 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 and search capabilities.
+
+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
+
+EXAMPLES:
+1. Find all pages: list-pages (no params)
+2. Find pages tagged "marketing": list-pages with tags="marketing"
+3. Find pages mentioning "dashboard": list-pages with search="dashboard"
+4. Find pages with "admin" in title: list-pages with search="admin", key="title"
+5. Find pages where vendor is "Apple": list-pages with search="Apple", key="metadata", metadata_key="vendor"
+
+Returns: Array of page summaries (id, slug, title, url, tags, metadata, timestamps). Does not include page content.`,
   inputSchema: {
     type: "object",
-    properties: {},
+    properties: {
+      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",
+      },
+    },
   },
 };
 
-export async function handleListPages() {
+export async function handleListPages(args?: unknown) {
+  const { tags, search, key, metadata_key } = (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);
+
+  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: [

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,6 +16,7 @@ export interface PageSummary {
   title: string;
   url: string;
   tags?: string[];
+  metadata?: Record<string, unknown>;
   created_at: string;
   updated_at: string;
 }
@@ -29,6 +31,7 @@ export interface UpdatePageArgs {
   title?: string;
   content?: string;
   tags?: string[];
+  metadata?: Record<string, unknown>;
 }
 
 export interface UpdatePageResponse {
@@ -43,3 +46,23 @@ export interface DeletePageArgs {
 export interface DeletePageResponse {
   message: string;
 }
+
+export interface GetPageArgs {
+  slug: string;
+}
+
+export interface GetPageResponse {
+  id: number;
+  slug: string;
+  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;
+}