MCP WordPress Server

Instructions

Implementation Reference

• src/tools/posts/PostHandlers.ts:356-406 (handler)

  Core handler function that executes the wp_update_post tool: validates parameters, fetches original post for change detection, performs the update via WordPressClient, generates a summary of changes, and returns formatted response.
  export async function handleUpdatePost( client: WordPressClient, params: UpdatePostRequest & { id: number }, ): Promise<WordPressPost | string> { try { const postId = validateId(params.id, "post ID"); // Get original post to show what changed const originalPost = await client.getPost(postId); const { id: _id, ...updateData } = params; validatePostParams(updateData); const updatedPost = await client.updatePost({ id: postId, ...updateData }); // Build change summary let response = `✅ **Post Updated Successfully**\n\n`; response += `**Title**: ${updatedPost.title.rendered}\n`; response += `**ID**: ${updatedPost.id}\n`; response += `**Status**: ${updatedPost.status}\n`; response += `**Modified**: ${new Date(updatedPost.modified).toLocaleString()}\n`; // Show what changed const changes: string[] = []; if (params.title && originalPost.title.rendered !== updatedPost.title.rendered) { changes.push(`Title: "${originalPost.title.rendered}" → "${updatedPost.title.rendered}"`); } if (params.status && originalPost.status !== updatedPost.status) { changes.push(`Status: "${originalPost.status}" → "${updatedPost.status}"`); } if (params.content && originalPost.content?.rendered !== updatedPost.content?.rendered) { changes.push("Content updated"); } if (params.excerpt && originalPost.excerpt?.rendered !== updatedPost.excerpt?.rendered) { changes.push("Excerpt updated"); } if (changes.length > 0) { response += `\n**Changes Made**:\n${changes.map((c) => `- ${c}`).join("\n")}\n`; } response += `\n**Link**: ${updatedPost.link}`; 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 update post: ${getErrorMessage(_error)}`); } }
• src/tools/posts/PostToolDefinitions.ts:142-199 (schema)

  Input schema definition for the wp_update_post tool, including all parameters, descriptions, types, and required fields.
  export const updatePostTool: MCPTool = { name: "wp_update_post", description: "Updates an existing WordPress post with comprehensive validation and change tracking. All parameters except ID are optional - only provided fields will be updated.\n\n" + "**Usage Examples:**\n" + '• Update title: `wp_update_post --id=123 --title="New Title"`\n' + '• Update content: `wp_update_post --id=123 --content="<p>Updated content</p>"`\n' + '• Change status: `wp_update_post --id=123 --status="publish"`\n' + "• Update categories: `wp_update_post --id=123 --categories=[1,5,10]`\n" + "• Set featured image: `wp_update_post --id=123 --featured_media=42`\n" + "• Remove featured image: `wp_update_post --id=123 --featured_media=0`\n" + '• Multiple updates: `wp_update_post --id=123 --title="New Title" --status="publish" --categories=[1,2]`', inputSchema: { type: "object", properties: { id: { type: "number", description: "The ID of the post to update.", }, title: { type: "string", description: "The new title for the post.", }, content: { type: "string", description: "The new content for the post, in HTML format.", }, status: { type: "string", description: "The new publishing status for the post.", enum: ["publish", "draft", "pending", "private"], }, excerpt: { type: "string", description: "The new excerpt for the post.", }, categories: { type: "array", items: { type: "number" }, description: "An array of category IDs to assign to the post.", }, tags: { type: "array", items: { type: "number" }, description: "An array of tag IDs to assign to the post.", }, featured_media: { type: "number", description: "The ID of the featured media (image). Use 0 to remove featured media.", }, date: { type: "string", description: "The date the post was published, in the site's timezone (ISO 8601 format).", }, }, required: ["id"], }, };
• src/tools/posts/index.ts:90-107 (registration)

  Switch statement in PostTools.getHandlerForTool that binds the handleUpdatePost method as the handler for 'wp_update_post' tool.
  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:73-77 (registration)

  PostTools.getTools() method that combines tool definitions with their bound handlers, making the tools ready for MCP server registration.
  public getTools(): unknown[] { return postToolDefinitions.map((toolDef) => ({ ...toolDef, handler: this.getHandlerForTool(toolDef.name), }));
• src/server/ToolRegistry.ts:45-62 (registration)

  ToolRegistry.registerAllTools() instantiates PostTools (via Tools import) and registers all its tools including wp_update_post with the MCP server.
  public registerAllTools(): void { // Register all tools from the tools directory Object.values(Tools).forEach((ToolClass) => { let toolInstance: { getTools(): unknown[] }; // Cache and Performance tools need the clients map if (ToolClass.name === "CacheTools" || ToolClass.name === "PerformanceTools") { toolInstance = new ToolClass(this.wordpressClients); } else { toolInstance = new (ToolClass as new () => { getTools(): unknown[] })(); } const tools = toolInstance.getTools(); tools.forEach((tool: unknown) => { this.registerTool(tool as ToolDefinition); }); });