WordPress MCP Server

Instructions

Implementation Reference

• src/index.ts:1018-1062 (handler)

  The async handler function for the 'get-comments' tool. It constructs API parameters, calls makeWPRequest to fetch comments from the WP REST API /wp-json/wp/v2/comments endpoint, formats the response, and returns a structured text content response.

  async ({ siteUrl, username, password, postId, perPage = 10, page = 1 }) => {
    try {
      const params: Record<string, any> = { per_page: perPage, page };
      if (postId !== undefined) params.post = postId;
      
      const comments = await makeWPRequest<WPComment[]>({
        siteUrl,
        endpoint: "comments",
        auth: { username, password },
        params
      });
      
      const formattedComments = Array.isArray(comments) ? comments.map(comment => ({
        id: comment.id,
        author_name: comment.author_name || "Anonymous",
        content: comment.content?.rendered || "No content",
        post: comment.post || "Unknown post",
        date: comment.date || "No date"
      })) : [];
      
      const commentsText = formattedComments.length > 0
        ? formattedComments.map(comment => 
            `ID: ${comment.id}\nAuthor: ${comment.author_name}\nDate: ${comment.date}\nContent: ${comment.content}\n---`
          ).join("\n")
        : "No comments found";
      
      return {
        content: [
          {
            type: "text",
            text: `Comments from ${siteUrl}${postId ? ` for post #${postId}` : ''}:\n\n${commentsText}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error retrieving comments: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }

• src/index.ts:1011-1017 (schema)

  Zod input schema defining parameters for the get-comments tool: required siteUrl, username, password; optional postId, perPage (1-100), page.

    siteUrl: z.string().url().describe("WordPress site URL"),
    username: z.string().describe("WordPress username"),
    password: z.string().describe("WordPress application password"),
    postId: z.number().optional().describe("Filter comments by post ID"),
    perPage: z.number().min(1).max(100).optional().describe("Number of comments per page"),
    page: z.number().min(1).optional().describe("Page number"),
  },

• src/index.ts:1007-1063 (registration)

  Registration of the 'get-comments' tool on the McpServer instance using server.tool(name, description, inputSchema, handlerFn).

  server.tool(
    "get-comments",
    "Get a list of comments from a WordPress site",
    {
      siteUrl: z.string().url().describe("WordPress site URL"),
      username: z.string().describe("WordPress username"),
      password: z.string().describe("WordPress application password"),
      postId: z.number().optional().describe("Filter comments by post ID"),
      perPage: z.number().min(1).max(100).optional().describe("Number of comments per page"),
      page: z.number().min(1).optional().describe("Page number"),
    },
    async ({ siteUrl, username, password, postId, perPage = 10, page = 1 }) => {
      try {
        const params: Record<string, any> = { per_page: perPage, page };
        if (postId !== undefined) params.post = postId;
        
        const comments = await makeWPRequest<WPComment[]>({
          siteUrl,
          endpoint: "comments",
          auth: { username, password },
          params
        });
        
        const formattedComments = Array.isArray(comments) ? comments.map(comment => ({
          id: comment.id,
          author_name: comment.author_name || "Anonymous",
          content: comment.content?.rendered || "No content",
          post: comment.post || "Unknown post",
          date: comment.date || "No date"
        })) : [];
        
        const commentsText = formattedComments.length > 0
          ? formattedComments.map(comment => 
              `ID: ${comment.id}\nAuthor: ${comment.author_name}\nDate: ${comment.date}\nContent: ${comment.content}\n---`
            ).join("\n")
          : "No comments found";
        
        return {
          content: [
            {
              type: "text",
              text: `Comments from ${siteUrl}${postId ? ` for post #${postId}` : ''}:\n\n${commentsText}`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error retrieving comments: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
        };
      }
    }
  );

• src/index.ts:66-75 (schema)

  TypeScript interface WPComment used to type the API response data in the handler.

  interface WPComment {
    id: number;
    author_name?: string;
    content?: {
      rendered: string;
    };
    post?: number;
    date?: string;
  }

• src/index.ts:158-194 (helper)

  Shared helper function makeWPRequest used by get-comments (and other tools) to make authenticated requests to WordPress REST API endpoints.

  async function makeWPRequest<T>({
    siteUrl, 
    endpoint,
    method = 'GET',
    auth,
    data = null,
    params = null
  }: {
    siteUrl: string;
    endpoint: string;
    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
    auth: { username: string; password: string };
    data?: any;
    params?: any;
  }): Promise<T> {
    const authString = Buffer.from(`${auth.username}:${auth.password}`).toString('base64');
    
    try {
      const response = await axios({
        method,
        url: `${siteUrl}/wp-json/wp/v2/${endpoint}`,
        headers: {
          'Authorization': `Basic ${authString}`,
          'Content-Type': 'application/json',
        },
        data: data,
        params: params
      });
      
      return response.data as T;
    } catch (error) {
      if (axios.isAxiosError(error) && error.response) {
        throw new Error(`WordPress API error: ${error.response.data?.message || error.message}`);
      }
      throw error;
    }
  }