MCP WordPress Server

Instructions

Implementation Reference

• src/tools/media.ts:175-192 (registration)

  Tool registration and schema definition for wp_delete_media, including name, description, input parameters (id: number required, force: boolean optional), and handler binding.

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

• src/tools/media.ts:256-265 (handler)

  The core handler function that implements wp_delete_media tool logic: extracts id and force params, calls WordPressClient.deleteMedia, handles success response and errors.

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