MCP WordPress Server

Instructions

Implementation Reference

• src/tools/posts/PostHandlers.ts:225-315 (handler)

  Core execution logic for wp_get_post tool: validates ID, fetches post via WordPressClient.getPost, enriches with author/categories/tags info, computes word count, formats detailed Markdown response including optional full content and admin links.

  export async function handleGetPost(
    client: WordPressClient,
    params: { id: number; include_content?: boolean },
  ): Promise<WordPressPost | string> {
    try {
      const postId = validateId(params.id, "post ID");
      const post = await client.getPost(postId);
  
      // Get additional metadata for comprehensive response
      const [author, categories, tags] = await Promise.all([
        // Get author information
        post.author
          ? client.getUser(post.author).catch(() => ({ name: `User ${post.author}`, username: `user${post.author}` }))
          : null,
        // Get categories
        post.categories && post.categories.length > 0
          ? Promise.all(post.categories.map((id) => client.getCategory(id).catch(() => ({ id, name: `Category ${id}` }))))
          : [],
        // Get tags
        post.tags && post.tags.length > 0
          ? Promise.all(post.tags.map((id) => client.getTag(id).catch(() => ({ id, name: `Tag ${id}` }))))
          : [],
      ]);
  
      // Format post content
      const date = new Date(post.date);
      const modifiedDate = new Date(post.modified);
      const formattedDate = date.toLocaleDateString("en-US", {
        year: "numeric",
        month: "short",
        day: "numeric",
        hour: "2-digit",
        minute: "2-digit",
      });
      const formattedModified = modifiedDate.toLocaleDateString("en-US", {
        year: "numeric",
        month: "short",
        day: "numeric",
        hour: "2-digit",
        minute: "2-digit",
      });
  
      const content = post.content?.rendered || "";
      const excerpt = post.excerpt?.rendered ? sanitizeHtml(post.excerpt.rendered).trim() : "";
      const wordCount = sanitizeHtml(content).split(/\s+/).filter(Boolean).length;
  
      // Build comprehensive response
      let response = `# ${post.title.rendered}\n\n`;
      response += `**Post ID**: ${post.id}\n`;
      response += `**Status**: ${post.status}\n`;
      response += `**Author**: ${author?.name || author?.username || `User ${post.author}`}\n`;
      response += `**Published**: ${formattedDate}\n`;
      response += `**Modified**: ${formattedModified}\n`;
  
      if (categories.length > 0) {
        response += `**Categories**: ${categories.map((c) => c.name).join(", ")}\n`;
      }
  
      if (tags.length > 0) {
        response += `**Tags**: ${tags.map((t) => t.name).join(", ")}\n`;
      }
  
      response += `**Word Count**: ${wordCount}\n`;
      response += `**Link**: ${post.link}\n`;
  
      if (excerpt) {
        response += `\n## Excerpt\n${excerpt}\n`;
      }
  
      // Only include full content if explicitly requested (for backward compatibility, default to true)
      const includeContent = params.include_content !== false;
      if (content && includeContent) {
        response += `\n## Content\n${content}\n`;
      }
  
      // Add management links and metadata
      const siteUrl = client.getSiteUrl ? client.getSiteUrl() : "";
      if (siteUrl) {
        response += `\n## Management\n`;
        response += `- **Edit**: ${siteUrl}/wp-admin/post.php?post=${post.id}&action=edit\n`;
        response += `- **Preview**: ${siteUrl}/?p=${post.id}&preview=true\n`;
      }
  
      return response;
    } catch (_error) {
      if (_error instanceof Error && _error.message.includes("404")) {
        return `Post with ID ${params.id} not found. Please verify the ID and try again.`;
      }
      throw new Error(`Failed to get post: ${getErrorMessage(_error)}`);
    }
  }

• src/tools/posts/PostToolDefinitions.ts:58-79 (schema)

  Input schema and description definition for the wp_get_post tool, including parameters id (required) and include_content (optional).

  export const getPostTool: MCPTool = {
    name: "wp_get_post",
    description:
      "Retrieves detailed information about a single post including metadata, content statistics, and management links. Optionally includes full HTML content for editing.\n\n" +
      "**Usage Examples:**\n" +
      "• Basic metadata: `wp_get_post --id=123`\n" +
      "• With full content: `wp_get_post --id=123 --include_content=true`",
    inputSchema: {
      type: "object",
      properties: {
        id: {
          type: "number",
          description: "The unique identifier for the post.",
        },
        include_content: {
          type: "boolean",
          description: "If true, includes the full HTML content of the post for editing. Default: false",
        },
      },
      required: ["id"],
    },
  };

• src/tools/posts/index.ts:90-107 (registration)

  Registers the wp_get_post tool by mapping its definition to the bound handler this.handleGetPost in PostTools.getTools(), which is used for MCP tool registration.

  private getHandlerForTool(toolName: string) {
    switch (toolName) {
      case "wp_list_posts":
        return this.handleListPosts.bind(this);
      case "wp_get_post":
        return this.handleGetPost.bind(this);
      case "wp_create_post":
        return this.handleCreatePost.bind(this);
      case "wp_update_post":
        return this.handleUpdatePost.bind(this);
      case "wp_delete_post":
        return this.handleDeletePost.bind(this);
      case "wp_get_post_revisions":
        return this.handleGetPostRevisions.bind(this);
      default:
        throw new Error(`Unknown tool: ${toolName}`);
    }
  }

• src/tools/posts/index.ts:158-168 (handler)

  Wrapper method in PostTools class that extracts parameters and delegates to the core handleGetPost function from PostHandlers.

  public async handleGetPost(
    client: WordPressClient,
    params: { id: number } | Record<string, unknown>,
  ): Promise<WordPressPost | string> {
    // Extract only the relevant parameters
    const postParams = {
      id: params.id as number,
    };
  
    return handleGetPost(client, postParams);
  }

• src/tools/posts/PostToolDefinitions.ts:250-257 (registration)

  Includes wp_get_post tool definition (getPostTool) in the array of post tool definitions used for registration.

  export const postToolDefinitions = [
    listPostsTool,
    getPostTool,
    createPostTool,
    updatePostTool,
    deletePostTool,
    getPostRevisionsTool,
  ];