MCP WordPress Server

Instructions

Implementation Reference

• src/tools/pages.ts:213-221 (handler)

  The handler function that implements the core logic of the wp_delete_page tool. It calls the WordPressClient's deletePage method and formats the response.

  public async handleDeletePage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
    const { id, force } = params as { id: number; force?: boolean };
    try {
      await client.deletePage(id, force);
      const action = params.force ? "permanently deleted" : "moved to trash";
      return `✅ Page ${id} has been ${action}.`;
    } catch (_error) {
      throw new Error(`Failed to delete page: ${getErrorMessage(_error)}`);
    }

• src/tools/pages.ts:122-139 (registration)

  The tool definition in PageTools.getTools(), which registers the wp_delete_page tool with its schema (parameters), description, and handler reference. This array is consumed by the ToolRegistry.

  {
    name: "wp_delete_page",
    description: "Deletes a page.",
    parameters: [
      {
        name: "id",
        type: "number",
        required: true,
        description: "The ID of the page to delete.",
      },
      {
        name: "force",
        type: "boolean",
        description: "If true, permanently delete. If false, move to trash. Defaults to false.",
      },
    ],
    handler: this.handleDeletePage.bind(this),
  },

• src/server/ToolRegistry.ts:45-63 (registration)

  Registers all tool classes from src/tools/index.ts, including PageTools containing wp_delete_page, by calling getTools() and registering each tool 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);
      });
    });
  }