@jgardner04/ghost-mcp-server 1.13.2 → 1.13.3

package/src/__tests__/mcp_server_pages.test.js

@@ -175,7 +175,7 @@ describe('mcp_server - ghost_get_pages tool', () => {
     const tool = mockTools.get('ghost_get_pages');
     const result = await tool.handler({});
 
-    expect(mockGetPages).toHaveBeenCalledWith({});
+    expect(mockGetPages).toHaveBeenCalledWith(expect.objectContaining({}));
     expect(result.content[0].text).toContain('About Us');
     expect(result.content[0].text).toContain('Contact');
   });
@@ -187,7 +187,7 @@ describe('mcp_server - ghost_get_pages tool', () => {
     const tool = mockTools.get('ghost_get_pages');
     await tool.handler({ limit: 10, page: 2 });
 
-    expect(mockGetPages).toHaveBeenCalledWith({ limit: 10, page: 2 });
+    expect(mockGetPages).toHaveBeenCalledWith(expect.objectContaining({ limit: 10, page: 2 }));
   });
 
   it('should validate limit is between 1 and 100', () => {
@@ -207,7 +207,9 @@ describe('mcp_server - ghost_get_pages tool', () => {
     const tool = mockTools.get('ghost_get_pages');
     await tool.handler({ filter: 'status:published' });
 
-    expect(mockGetPages).toHaveBeenCalledWith({ filter: 'status:published' });
+    expect(mockGetPages).toHaveBeenCalledWith(
+      expect.objectContaining({ filter: 'status:published' })
+    );
   });
 
   it('should handle errors gracefully', async () => {
@@ -236,8 +238,8 @@ describe('mcp_server - ghost_get_page tool', () => {
   it('should have correct schema with id and slug options', () => {
     const tool = mockTools.get('ghost_get_page');
     expect(tool).toBeDefined();
-    // ghost_get_page uses a refined schema, access via _def.schema.shape
-    const shape = tool.schema._def.schema.shape;
+    // In Zod v4, refined schemas expose .shape directly
+    const shape = tool.schema.shape;
     expect(shape.id).toBeDefined();
     expect(shape.slug).toBeDefined();
     expect(shape.include).toBeDefined();
@@ -250,7 +252,10 @@ describe('mcp_server - ghost_get_page tool', () => {
     const tool = mockTools.get('ghost_get_page');
     const result = await tool.handler({ id: '507f1f77bcf86cd799439011' });
 
-    expect(mockGetPage).toHaveBeenCalledWith('507f1f77bcf86cd799439011', {});
+    expect(mockGetPage).toHaveBeenCalledWith(
+      '507f1f77bcf86cd799439011',
+      expect.objectContaining({})
+    );
     expect(result.content[0].text).toContain('About Us');
   });
 
@@ -261,7 +266,7 @@ describe('mcp_server - ghost_get_page tool', () => {
     const tool = mockTools.get('ghost_get_page');
     const result = await tool.handler({ slug: 'about-us' });
 
-    expect(mockGetPage).toHaveBeenCalledWith('slug/about-us', {});
+    expect(mockGetPage).toHaveBeenCalledWith('slug/about-us', expect.objectContaining({}));
     expect(result.content[0].text).toContain('About Us');
   });
 
@@ -389,9 +394,12 @@ describe('mcp_server - ghost_update_page tool', () => {
     const tool = mockTools.get('ghost_update_page');
     const result = await tool.handler({ id: '507f1f77bcf86cd799439011', title: 'Updated Title' });
 
-    expect(mockUpdatePage).toHaveBeenCalledWith('507f1f77bcf86cd799439011', {
-      title: 'Updated Title',
-    });
+    expect(mockUpdatePage).toHaveBeenCalledWith(
+      '507f1f77bcf86cd799439011',
+      expect.objectContaining({
+        title: 'Updated Title',
+      })
+    );
     expect(result.content[0].text).toContain('Updated Title');
   });
 
@@ -407,11 +415,14 @@ describe('mcp_server - ghost_update_page tool', () => {
       html: '<p>Updated content</p>',
     });
 
-    expect(mockUpdatePage).toHaveBeenCalledWith('507f1f77bcf86cd799439011', {
-      title: 'New Title',
-      status: 'published',
-      html: '<p>Updated content</p>',
-    });
+    expect(mockUpdatePage).toHaveBeenCalledWith(
+      '507f1f77bcf86cd799439011',
+      expect.objectContaining({
+        title: 'New Title',
+        status: 'published',
+        html: '<p>Updated content</p>',
+      })
+    );
     expect(result.content[0].text).toContain('New Title');
   });
 
@@ -493,7 +504,7 @@ describe('mcp_server - ghost_search_pages tool', () => {
     const tool = mockTools.get('ghost_search_pages');
     const result = await tool.handler({ query: 'about' });
 
-    expect(mockSearchPages).toHaveBeenCalledWith('about', {});
+    expect(mockSearchPages).toHaveBeenCalledWith('about', expect.objectContaining({}));
     expect(result.content[0].text).toContain('About Us');
   });
 
@@ -504,7 +515,10 @@ describe('mcp_server - ghost_search_pages tool', () => {
     const tool = mockTools.get('ghost_search_pages');
     await tool.handler({ query: 'test', status: 'published' });
 
-    expect(mockSearchPages).toHaveBeenCalledWith('test', { status: 'published' });
+    expect(mockSearchPages).toHaveBeenCalledWith(
+      'test',
+      expect.objectContaining({ status: 'published' })
+    );
   });
 
   it('should pass limit option', async () => {
@@ -514,7 +528,7 @@ describe('mcp_server - ghost_search_pages tool', () => {
     const tool = mockTools.get('ghost_search_pages');
     await tool.handler({ query: 'test', limit: 5 });
 
-    expect(mockSearchPages).toHaveBeenCalledWith('test', { limit: 5 });
+    expect(mockSearchPages).toHaveBeenCalledWith('test', expect.objectContaining({ limit: 5 }));
   });
 
   it('should validate limit is between 1 and 50', () => {

package/src/config/mcp-config.js

@@ -1,6 +1,6 @@
 import dotenv from 'dotenv';
 
-dotenv.config();
+dotenv.config({ quiet: true });
 
 /**
  * MCP Server Configuration

package/src/controllers/__tests__/tagController.test.js

@@ -44,7 +44,7 @@ describe('tagController', () => {
 
       await getTags(req, res, next);
 
-      expect(ghostService.getTags).toHaveBeenCalledWith({});
+      expect(ghostService.getTags).toHaveBeenCalledWith(expect.objectContaining({}));
       expect(res.status).toHaveBeenCalledWith(200);
       expect(res.json).toHaveBeenCalledWith(mockTags);
       expect(next).not.toHaveBeenCalled();
@@ -60,7 +60,9 @@ describe('tagController', () => {
 
       await getTags(req, res, next);
 
-      expect(ghostService.getTags).toHaveBeenCalledWith({ filter: "name:'Technology'" });
+      expect(ghostService.getTags).toHaveBeenCalledWith(
+        expect.objectContaining({ filter: "name:'Technology'" })
+      );
       expect(res.status).toHaveBeenCalledWith(200);
       expect(res.json).toHaveBeenCalledWith(mockTags);
       expect(next).not.toHaveBeenCalled();
@@ -76,7 +78,7 @@ describe('tagController', () => {
 
       await getTags(req, res, next);
 
-      expect(ghostService.getTags).toHaveBeenCalledWith({});
+      expect(ghostService.getTags).toHaveBeenCalledWith(expect.objectContaining({}));
       expect(res.status).not.toHaveBeenCalled();
       expect(res.json).not.toHaveBeenCalled();
       expect(next).toHaveBeenCalledWith(mockError);
@@ -121,11 +123,13 @@ describe('tagController', () => {
 
       await getTags(req, res, next);
 
-      expect(ghostService.getTags).toHaveBeenCalledWith({
-        limit: 10,
-        order: 'name asc',
-        include: 'count.posts',
-      });
+      expect(ghostService.getTags).toHaveBeenCalledWith(
+        expect.objectContaining({
+          limit: 10,
+          order: 'name asc',
+          include: 'count.posts',
+        })
+      );
       expect(res.status).toHaveBeenCalledWith(200);
     });
 

package/src/controllers/tagController.js

@@ -43,10 +43,10 @@ const getTags = async (req, res, next) => {
     res.status(200).json(tags);
   } catch (error) {
     if (error instanceof ZodError) {
-      logger.warn('Invalid query parameters', { errors: error.errors });
+      logger.warn('Invalid query parameters', { errors: error.issues });
       return res.status(400).json({
         message: 'Invalid query parameters',
-        errors: error.errors.map((e) => ({ path: e.path.join('.'), message: e.message })),
+        errors: error.issues.map((e) => ({ path: e.path.join('.'), message: e.message })),
       });
     }
 

package/src/errors/__tests__/index.test.js

@@ -125,7 +125,7 @@ describe('Error Handling System', () => {
 
     it('should create validation error from Zod error', () => {
       const zodError = {
-        errors: [
+        issues: [
           {
             path: ['user', 'email'],
             message: 'Invalid email',
@@ -157,7 +157,7 @@ describe('Error Handling System', () => {
 
     it('should create validation error from Zod error with context', () => {
       const zodError = {
-        errors: [
+        issues: [
           {
             path: ['name'],
             message: 'String must contain at least 1 character(s)',
@@ -179,7 +179,7 @@ describe('Error Handling System', () => {
 
     it('should create validation error from Zod error with empty path', () => {
       const zodError = {
-        errors: [
+        issues: [
           {
             path: [],
             message: 'Invalid input',

package/src/errors/index.js

@@ -57,7 +57,7 @@ export class ValidationError extends BaseError {
   }
 
   static fromZod(zodError, context = '') {
-    const errors = zodError.errors.map((err) => ({
+    const errors = zodError.issues.map((err) => ({
       field: err.path.join('.'),
       message: err.message,
       type: err.code,

package/src/index.js

@@ -8,7 +8,7 @@ import tagRoutes from './routes/tagRoutes.js'; // Import tag routes
 import { createContextLogger } from './utils/logger.js';
 
 // Load environment variables from .env file
-dotenv.config();
+dotenv.config({ quiet: true });
 
 // Initialize logger for main server
 const logger = createContextLogger('main');

package/src/mcp_server.js

@@ -35,7 +35,7 @@ import {
 } from './schemas/index.js';
 
 // Load environment variables
-dotenv.config();
+dotenv.config({ quiet: true });
 
 // Lazy-loaded modules (to avoid Node.js v25 Buffer compatibility issues at startup)
 let ghostService = null;
@@ -95,12 +95,12 @@ const server = new McpServer({
 const getTagsSchema = tagQueryBaseSchema.partial();
 const getTagSchema = z
   .object({
-    id: ghostIdSchema.optional().describe('The ID of the tag to retrieve.'),
-    slug: z.string().optional().describe('The slug of the tag to retrieve.'),
+    id: ghostIdSchema.optional().meta({ description: 'The ID of the tag to retrieve.' }),
+    slug: z.string().optional().meta({ description: 'The slug of the tag to retrieve.' }),
     include: z
       .string()
       .optional()
-      .describe('Additional resources to include (e.g., "count.posts").'),
+      .meta({ description: 'Additional resources to include (e.g., "count.posts").' }),
   })
   .refine((data) => data.id || data.slug, {
     message: 'Either id or slug is required to retrieve a tag',
@@ -350,11 +350,11 @@ server.registerTool(
 
 // --- Image Schema ---
 const uploadImageSchema = z.object({
-  imageUrl: z.string().describe('The publicly accessible URL of the image to upload.'),
-  alt: z
-    .string()
-    .optional()
-    .describe('Alt text for the image. If omitted, a default will be generated from the filename.'),
+  imageUrl: z.string().meta({ description: 'The publicly accessible URL of the image to upload.' }),
+  alt: z.string().optional().meta({
+    description:
+      'Alt text for the image. If omitted, a default will be generated from the filename.',
+  }),
 });
 
 // Upload Image Tool
@@ -449,33 +449,32 @@ const getPostsSchema = postQuerySchema.extend({
   status: z
     .enum(['published', 'draft', 'scheduled', 'all'])
     .optional()
-    .describe('Filter posts by status. Options: published, draft, scheduled, all.'),
+    .meta({ description: 'Filter posts by status. Options: published, draft, scheduled, all.' }),
 });
 const getPostSchema = z
   .object({
-    id: ghostIdSchema.optional().describe('The ID of the post to retrieve.'),
-    slug: z.string().optional().describe('The slug of the post to retrieve.'),
-    include: z
-      .string()
-      .optional()
-      .describe('Comma-separated list of relations to include (e.g., "tags,authors").'),
+    id: ghostIdSchema.optional().meta({ description: 'The ID of the post to retrieve.' }),
+    slug: z.string().optional().meta({ description: 'The slug of the post to retrieve.' }),
+    include: z.string().optional().meta({
+      description: 'Comma-separated list of relations to include (e.g., "tags,authors").',
+    }),
   })
   .refine((data) => data.id || data.slug, {
     message: 'Either id or slug is required to retrieve a post',
   });
 const searchPostsSchema = z.object({
-  query: z.string().min(1).describe('Search query to find in post titles.'),
+  query: z.string().min(1).meta({ description: 'Search query to find in post titles.' }),
   status: z
     .enum(['published', 'draft', 'scheduled', 'all'])
     .optional()
-    .describe('Filter by post status. Default searches all statuses.'),
+    .meta({ description: 'Filter by post status. Default searches all statuses.' }),
   limit: z
     .number()
     .int()
     .min(1)
     .max(50)
     .optional()
-    .describe('Maximum number of results (1-50). Default is 15.'),
+    .meta({ description: 'Maximum number of results (1-50). Default is 15.' }),
 });
 const updatePostInputSchema = updatePostSchema.extend({ id: ghostIdSchema });
 const deletePostSchema = z.object({ id: ghostIdSchema });
@@ -762,29 +761,31 @@ server.registerTool(
 // --- Page Schema Definitions ---
 const getPageSchema = z
   .object({
-    id: ghostIdSchema.optional().describe('The ID of the page to retrieve.'),
-    slug: z.string().optional().describe('The slug of the page to retrieve.'),
+    id: ghostIdSchema.optional().meta({ description: 'The ID of the page to retrieve.' }),
+    slug: z.string().optional().meta({ description: 'The slug of the page to retrieve.' }),
     include: z
       .string()
       .optional()
-      .describe('Comma-separated list of relations to include (e.g., "authors").'),
+      .meta({ description: 'Comma-separated list of relations to include (e.g., "authors").' }),
   })
   .refine((data) => data.id || data.slug, {
     message: 'Either id or slug is required to retrieve a page',
   });
 const updatePageInputSchema = z
-  .object({ id: ghostIdSchema.describe('The ID of the page to update.') })
+  .object({ id: ghostIdSchema.meta({ description: 'The ID of the page to update.' }) })
   .merge(updatePageSchema);
-const deletePageSchema = z.object({ id: ghostIdSchema.describe('The ID of the page to delete.') });
+const deletePageSchema = z.object({
+  id: ghostIdSchema.meta({ description: 'The ID of the page to delete.' }),
+});
 const searchPagesSchema = z.object({
   query: z
     .string()
     .min(1, 'Search query cannot be empty')
-    .describe('Search query to find in page titles.'),
+    .meta({ description: 'Search query to find in page titles.' }),
   status: z
     .enum(['published', 'draft', 'scheduled', 'all'])
     .optional()
-    .describe('Filter by page status. Default searches all statuses.'),
+    .meta({ description: 'Filter by page status. Default searches all statuses.' }),
   limit: z
     .number()
     .int()
@@ -792,7 +793,7 @@ const searchPagesSchema = z.object({
     .max(50)
     .default(15)
     .optional()
-    .describe('Maximum number of results (1-50). Default is 15.'),
+    .meta({ description: 'Maximum number of results (1-50). Default is 15.' }),
 });
 
 // Get Pages Tool
@@ -1076,21 +1077,24 @@ const deleteMemberSchema = z.object({ id: ghostIdSchema });
 const getMembersSchema = memberQuerySchema.omit({ search: true });
 const getMemberSchema = z
   .object({
-    id: ghostIdSchema.optional().describe('The ID of the member to retrieve.'),
-    email: emailSchema.optional().describe('The email of the member to retrieve.'),
+    id: ghostIdSchema.optional().meta({ description: 'The ID of the member to retrieve.' }),
+    email: emailSchema.optional().meta({ description: 'The email of the member to retrieve.' }),
   })
   .refine((data) => data.id || data.email, {
     message: 'Either id or email must be provided',
   });
 const searchMembersSchema = z.object({
-  query: z.string().min(1).describe('Search query to match against member name or email.'),
+  query: z
+    .string()
+    .min(1)
+    .meta({ description: 'Search query to match against member name or email.' }),
   limit: z
     .number()
     .int()
     .min(1)
     .max(50)
     .optional()
-    .describe('Maximum number of results to return (1-50). Default is 15.'),
+    .meta({ description: 'Maximum number of results to return (1-50). Default is 15.' }),
 });
 
 // Create Member Tool

package/src/schemas/__tests__/postSchemas.test.js

@@ -1,4 +1,5 @@
 import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
 import {
   createPostSchema,
   updatePostSchema,
@@ -191,4 +192,22 @@ describe('Post Schemas', () => {
       expect(() => postOutputSchema.parse(apiPost)).not.toThrow();
     });
   });
+
+  describe('schema metadata', () => {
+    it('should expose descriptions via .meta()', () => {
+      expect(createPostSchema.shape.html.meta()?.description).toBe('HTML content of the post');
+      expect(createPostSchema.shape.tags.meta()?.description).toContain(
+        'Array of tag names or IDs'
+      );
+      expect(createPostSchema.shape.email_only.meta()?.description).toBe(
+        'Whether post is email-only'
+      );
+    });
+
+    it('should include descriptions in JSON Schema output', () => {
+      const jsonSchema = z.toJSONSchema(createPostSchema, { unrepresentable: 'any' });
+      expect(jsonSchema.properties.html.description).toBe('HTML content of the post');
+      expect(jsonSchema.properties.email_only.description).toBe('Whether post is email-only');
+    });
+  });
 });

package/src/schemas/__tests__/tagSchemas.test.js

@@ -245,7 +245,7 @@ describe('Tag Schemas', () => {
       try {
         tagQuerySchema.parse(query);
       } catch (error) {
-        expect(error.errors[0].message).toContain('Cannot specify both "name" and "filter"');
+        expect(error.issues[0].message).toContain('Cannot specify both "name" and "filter"');
       }
     });
 

package/src/schemas/common.js

@@ -135,7 +135,7 @@ export const paginationSchema = z.object({
  * Valid values: draft, published, scheduled
  */
 export const postStatusSchema = z.enum(['draft', 'published', 'scheduled'], {
-  errorMap: () => ({ message: 'Status must be draft, published, or scheduled' }),
+  error: () => ({ message: 'Status must be draft, published, or scheduled' }),
 });
 
 /**
@@ -143,7 +143,7 @@ export const postStatusSchema = z.enum(['draft', 'published', 'scheduled'], {
  * Controls content visibility (public, members, paid, tiers)
  */
 export const visibilitySchema = z.enum(['public', 'members', 'paid', 'tiers'], {
-  errorMap: () => ({ message: 'Visibility must be public, members, paid, or tiers' }),
+  error: () => ({ message: 'Visibility must be public, members, paid, or tiers' }),
 });
 
 // ----- Common Field Validators -----

package/src/schemas/memberSchemas.js

@@ -17,13 +17,22 @@ export const createMemberSchema = z.object({
   email: emailSchema,
   name: z.string().max(191, 'Name cannot exceed 191 characters').optional(),
   note: z.string().max(2000, 'Note cannot exceed 2000 characters').optional(),
-  subscribed: z.boolean().default(true).describe('Whether member is subscribed to newsletter'),
-  comped: z.boolean().default(false).describe('Whether member has complimentary subscription'),
-  labels: z.array(z.string()).optional().describe('Array of label names to associate with member'),
+  subscribed: z
+    .boolean()
+    .default(true)
+    .meta({ description: 'Whether member is subscribed to newsletter' }),
+  comped: z
+    .boolean()
+    .default(false)
+    .meta({ description: 'Whether member has complimentary subscription' }),
+  labels: z
+    .array(z.string())
+    .optional()
+    .meta({ description: 'Array of label names to associate with member' }),
   newsletters: z
     .array(ghostIdSchema)
     .optional()
-    .describe('Array of newsletter IDs to subscribe member to'),
+    .meta({ description: 'Array of newsletter IDs to subscribe member to' }),
 });
 
 /**
@@ -42,13 +51,16 @@ export const memberQuerySchema = z.object({
     .string()
     .regex(/^[a-zA-Z0-9_\-:.'"\s,[\]<>=!+]+$/, 'Invalid filter: contains disallowed characters')
     .optional()
-    .describe('NQL filter string (e.g., "status:paid+subscribed:true")'),
+    .meta({ description: 'NQL filter string (e.g., "status:paid+subscribed:true")' }),
   include: z
     .string()
     .optional()
-    .describe('Comma-separated list of relations (e.g., "labels,newsletters")'),
-  order: z.string().optional().describe('Order results (e.g., "created_at DESC", "name ASC")'),
-  search: z.string().optional().describe('Search members by name or email'),
+    .meta({ description: 'Comma-separated list of relations (e.g., "labels,newsletters")' }),
+  order: z
+    .string()
+    .optional()
+    .meta({ description: 'Order results (e.g., "created_at DESC", "name ASC")' }),
+  search: z.string().optional().meta({ description: 'Search members by name or email' }),
 });
 
 /**

package/src/schemas/newsletterSchemas.js

@@ -21,46 +21,46 @@ export const createNewsletterSchema = z.object({
   sender_email: emailSchema.optional(),
   sender_reply_to: z
     .enum(['newsletter', 'support'], {
-      errorMap: () => ({ message: 'Sender reply-to must be newsletter or support' }),
+      error: () => ({ message: 'Sender reply-to must be newsletter or support' }),
     })
     .default('newsletter'),
   status: z
     .enum(['active', 'archived'], {
-      errorMap: () => ({ message: 'Status must be active or archived' }),
+      error: () => ({ message: 'Status must be active or archived' }),
     })
     .default('active'),
   visibility: z
     .enum(['members', 'paid'], {
-      errorMap: () => ({ message: 'Visibility must be members or paid' }),
+      error: () => ({ message: 'Visibility must be members or paid' }),
     })
     .default('members'),
   subscribe_on_signup: z
     .boolean()
     .default(true)
-    .describe('Whether new members are automatically subscribed'),
+    .meta({ description: 'Whether new members are automatically subscribed' }),
   sort_order: z
     .number()
     .int()
     .min(0, 'Sort order must be non-negative')
     .optional()
-    .describe('Display order for newsletters'),
+    .meta({ description: 'Display order for newsletters' }),
   header_image: z.string().url('Invalid header image URL').optional(),
   show_header_icon: z.boolean().default(true),
   show_header_title: z.boolean().default(true),
   title_font_category: z
     .enum(['serif', 'sans-serif'], {
-      errorMap: () => ({ message: 'Title font category must be serif or sans-serif' }),
+      error: () => ({ message: 'Title font category must be serif or sans-serif' }),
     })
     .default('sans-serif'),
   title_alignment: z
     .enum(['left', 'center'], {
-      errorMap: () => ({ message: 'Title alignment must be left or center' }),
+      error: () => ({ message: 'Title alignment must be left or center' }),
     })
     .default('center'),
   show_feature_image: z.boolean().default(true),
   body_font_category: z
     .enum(['serif', 'sans-serif'], {
-      errorMap: () => ({ message: 'Body font category must be serif or sans-serif' }),
+      error: () => ({ message: 'Body font category must be serif or sans-serif' }),
     })
     .default('sans-serif'),
   footer_content: z.string().optional(),
@@ -85,11 +85,11 @@ export const newsletterQuerySchema = z.object({
     .string()
     .regex(/^[a-zA-Z0-9_\-:.'"\s,[\]<>=!+]+$/, 'Invalid filter: contains disallowed characters')
     .optional()
-    .describe('NQL filter string (e.g., "status:active")'),
+    .meta({ description: 'NQL filter string (e.g., "status:active")' }),
   order: z
     .string()
     .optional()
-    .describe('Order results (e.g., "sort_order ASC", "created_at DESC")'),
+    .meta({ description: 'Order results (e.g., "sort_order ASC", "created_at DESC")' }),
 });
 
 /**

package/src/schemas/pageSchemas.js

@@ -37,7 +37,7 @@ import {
  */
 export const createPageSchema = z.object({
   title: titleSchema,
-  html: htmlContentSchema.describe('HTML content of the page'),
+  html: htmlContentSchema.meta({ description: 'HTML content of the page' }),
   slug: slugSchema.optional(),
   status: postStatusSchema.default('draft'),
   visibility: visibilitySchema.default('public'),
@@ -59,16 +59,18 @@ export const createPageSchema = z.object({
     .max(500, 'Twitter description cannot exceed 500 characters')
     .optional(),
   canonical_url: canonicalUrlSchema,
-  tags: tagsSchema.describe('Array of tag names or IDs (rarely used for pages)'),
-  authors: authorsSchema.describe('Array of author IDs or emails'),
-  published_at: isoDateSchema.optional().describe('Scheduled publish time (ISO 8601 format)'),
+  tags: tagsSchema.meta({ description: 'Array of tag names or IDs (rarely used for pages)' }),
+  authors: authorsSchema.meta({ description: 'Array of author IDs or emails' }),
+  published_at: isoDateSchema
+    .optional()
+    .meta({ description: 'Scheduled publish time (ISO 8601 format)' }),
   codeinjection_head: z.string().optional(),
   codeinjection_foot: z.string().optional(),
-  custom_template: z.string().optional().describe('Custom template filename'),
+  custom_template: z.string().optional().meta({ description: 'Custom template filename' }),
   show_title_and_feature_image: z
     .boolean()
     .default(true)
-    .describe('Whether to show title and feature image on page'),
+    .meta({ description: 'Whether to show title and feature image on page' }),
 });
 
 /**
@@ -87,17 +89,20 @@ export const pageQuerySchema = z.object({
     .string()
     .regex(/^[a-zA-Z0-9_\-:.'"\s,[\]<>=!+]+$/, 'Invalid filter: contains disallowed characters')
     .optional()
-    .describe('NQL filter string (e.g., "status:published+featured:true")'),
+    .meta({ description: 'NQL filter string (e.g., "status:published+featured:true")' }),
   include: z
     .string()
     .optional()
-    .describe('Comma-separated list of relations (e.g., "tags,authors")'),
-  fields: z.string().optional().describe('Comma-separated list of fields to return'),
+    .meta({ description: 'Comma-separated list of relations (e.g., "tags,authors")' }),
+  fields: z.string().optional().meta({ description: 'Comma-separated list of fields to return' }),
   formats: z
     .string()
     .optional()
-    .describe('Comma-separated list of formats (html, plaintext, mobiledoc)'),
-  order: z.string().optional().describe('Order results (e.g., "published_at DESC", "title ASC")'),
+    .meta({ description: 'Comma-separated list of formats (html, plaintext, mobiledoc)' }),
+  order: z
+    .string()
+    .optional()
+    .meta({ description: 'Order results (e.g., "published_at DESC", "title ASC")' }),
 });
 
 /**