MCP WordPress Server

Instructions

Implementation Reference

• src/tools/posts/PostHandlers.ts:320-351 (handler)

  Core handler implementation for wp_create_post tool. Validates input parameters, creates the post via WordPressClient, and returns formatted success response with post details and admin links.
  export async function handleCreatePost( client: WordPressClient, params: CreatePostRequest, ): Promise<WordPressPost | string> { try { validatePostParams(params); const post = await client.createPost(params); // Build success response with management links let response = `✅ **Post Created Successfully**\n\n`; response += `**Title**: ${post.title.rendered}\n`; response += `**ID**: ${post.id}\n`; response += `**Status**: ${post.status}\n`; response += `**Link**: ${post.link}\n`; // Add management links 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`; if (post.status === "publish") { response += `- View: ${post.link}\n`; } else { response += `- Preview: ${siteUrl}/?p=${post.id}&preview=true\n`; } } return response; } catch (_error) { throw new Error(`Failed to create post: ${getErrorMessage(_error)}`); } }
• src/tools/posts/PostToolDefinitions.ts:84-137 (schema)

  Tool schema definition including name, detailed description with usage examples, and inputSchema with parameters, validation (required title, optional others), and enums.
  export const createPostTool: MCPTool = { name: "wp_create_post", description: "Creates a new WordPress post with comprehensive validation and detailed success feedback including management links.\n\n" + "**Usage Examples:**\n" + '• Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"`\n' + '• Draft post: `wp_create_post --title="Draft Post" --status="draft"`\n' + '• Categorized post: `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]`\n' + '• Post with featured image: `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42`\n' + '• Remove featured image: `wp_create_post --title="My Post" --featured_media=0`\n' + '• Scheduled post: `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"`\n' + '• Complete post: `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`', inputSchema: { type: "object", properties: { title: { type: "string", description: "The title for the post.", }, content: { type: "string", description: "The content for the post, in HTML format.", }, status: { type: "string", description: "The publishing status for the post.", enum: ["publish", "draft", "pending", "private"], }, excerpt: { type: "string", description: "The 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: ["title"], }, };
• src/tools/posts/index.ts:90-107 (registration)

  Registration mapping: binds the tool name 'wp_create_post' to the handleCreatePost method in the PostTools class's getHandlerForTool switch statement, used by getTools() to attach handlers to tool definitions.
  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:177-195 (handler)

  Wrapper handler in PostTools class that extracts and type-casts MCP input parameters before delegating to the core handleCreatePost function.
  public async handleCreatePost( client: WordPressClient, params: CreatePostRequest | Record<string, unknown>, ): Promise<WordPressPost | string> { // Extract only the relevant post creation parameters, excluding MCP-specific fields like 'site' const postParams: CreatePostRequest = { title: params.title as string, }; if (params.content !== undefined) postParams.content = params.content as string; if (params.status !== undefined) postParams.status = params.status as PostStatus; if (params.excerpt !== undefined) postParams.excerpt = params.excerpt as string; if (params.categories !== undefined) postParams.categories = params.categories as number[]; if (params.tags !== undefined) postParams.tags = params.tags as number[]; if (params.featured_media !== undefined) postParams.featured_media = params.featured_media as number; if (params.date !== undefined) postParams.date = params.date as string; return handleCreatePost(client, postParams); }